Planning With Files

Get it working

Install → restart → verify. Stay on this page until Planning With Files responds.

1. 01

   Copy the install command

   Use the command on this page — it includes the correct --skill flag for this skill.

2. 02

   Run it in your project terminal

   Execute the command from the directory where you use Codex, not necessarily your home folder.

3. 03

   Restart or reload Codex

   Restart the Codex CLI or reload your IDE window so the new extension is picked up.

4. 04

   Verify with a prompt

   Try one of the verify prompts below to confirm Planning With Files is active.

If install fails

Fix these common issues before digging into GitHub issues.

• Command not found or install fails

  Use Node.js 18+ and confirm npx works. Corporate proxies may need HTTPS_PROXY set for GitHub and npm.

• Installed but Codex ignores it

  Restart the Codex CLI or reload the IDE window. Confirm you used the correct --plugin / --skill / --hook flag.

• Skill never seems to load

  Ask Codex to use the skill by name in your prompt, or check that the skill appears in your local Codex skills list after install.

About

Key features

• Specialized agent instructions for productivity tasks
• Lighter than a full plugin — focused playbook the agent loads on demand
• Install with the --skill flag via npx
• Ideal when you want Planning With Files expertise without a full integration

Requirements

• Node.js 18 or newer with npx available
• Codex CLI or IDE extension installed and signed in