# planning-with-files

> Persistent file-based planning for multi-step AI-agent work.

Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.

- Type: Skill
- Made by: OthmanAdi
- Category: AI & agents
- Formats: Skills
- Version: 3.25.2
- Source: https://github.com/othmanadi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files
- Page: https://pluginboard.ai/skills/planning-with-files-othmanadi-4

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the planning-with-files folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### Claude

In Claude (web or desktop): Download the planning-with-files folder and zip the folder itself, then upload it in Customize → Skills.

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### Gemini

In Gemini: Download the planning-with-files folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### GitHub Copilot

Run in your terminal:

```shell
npx -y degit OthmanAdi/planning-with-files/.cursor/skills/planning-with-files ~/.copilot/skills/planning-with-files
```

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### Cursor

Run in your terminal:

```shell
npx -y degit OthmanAdi/planning-with-files/.cursor/skills/planning-with-files ~/.cursor/skills/planning-with-files
```

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### Claude Code

Run in your terminal:

```shell
npx -y degit OthmanAdi/planning-with-files/.cursor/skills/planning-with-files ~/.claude/skills/planning-with-files
```

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

Or all of Planning with Files, in Claude Code:

```text
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files
```

### Codex

Run in your terminal:

```shell
npx -y degit OthmanAdi/planning-with-files/.cursor/skills/planning-with-files ~/.agents/skills/planning-with-files
```

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### Antigravity

In Antigravity: Copy the planning-with-files folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### Gemini CLI

Run in your terminal:

```shell
npx -y degit OthmanAdi/planning-with-files/.cursor/skills/planning-with-files ~/.gemini/skills/planning-with-files
```

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### Replit

Run in your terminal:

```shell
npx -y degit OthmanAdi/planning-with-files/.cursor/skills/planning-with-files .agents/skills/planning-with-files
```

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### OpenClaw

Run in your terminal:

```shell
npx -y degit OthmanAdi/planning-with-files/.cursor/skills/planning-with-files ~/.openclaw/skills/planning-with-files
```

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### OpenCode

Run in your terminal:

```shell
npx -y degit OthmanAdi/planning-with-files/.cursor/skills/planning-with-files ~/.config/opencode/skills/planning-with-files
```

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

### Hermes Agent

Run in your terminal:

```shell
npx -y degit OthmanAdi/planning-with-files/.cursor/skills/planning-with-files ~/.hermes/skills/planning-with-files
```

View the folder on GitHub: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.cursor/skills/planning-with-files

---
From Pluginboard (https://pluginboard.ai).