OthmanAdi/planning-with-files

Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60+ agents.

27kStars on the repository
28Mods indexed here, across every type
2d agoLast push, which is what freshness is scored on
MITLicence, which decides whether bodies are shown

SessionStart

01

OthmanAdi/planning-with-files

Hook

Runs when a session starts on startup, resume, clear and compact, running sh. From OthmanAdi/planning-with-files.

27k +125 2d ago A tokens not measured original MIT

UserPromptSubmit

02

OthmanAdi/planning-with-files

Hook

Runs when you submit a prompt, before the agent sees it, running sh. From OthmanAdi/planning-with-files.

27k +125 2d ago A tokens not measured original MIT

PreToolUse

03

OthmanAdi/planning-with-files

Hook

Runs before the agent uses a tool for Write, Edit, Bash, Read, Glob and Grep tool calls, running sh. From OthmanAdi/planning-with-files.

27k +125 2d ago A tokens not measured original MIT

PostToolUse

04

OthmanAdi/planning-with-files

Hook

Runs after a tool call finishes for Write, Edit and Bash tool calls, running sh. From OthmanAdi/planning-with-files.

27k +125 2d ago A tokens not measured original MIT

PreCompact

05

OthmanAdi/planning-with-files

Hook

Runs before the context is compacted, running sh. From OthmanAdi/planning-with-files.

27k +125 2d ago A tokens not measured original MIT

Stop

06

OthmanAdi/planning-with-files

Hook

Runs when the agent finishes a response, running sh. From OthmanAdi/planning-with-files.

27k +125 2d ago A tokens not measured original MIT