Skip to content
BENIBIX Learn

plansDirectory

AI⌨️ Claude CodeConfiguration

Also known as plansDirectory setting

The key that sets the folder where plan mode saves its plans.

Think of it like

It is like picking the shelf where your notes go.

Example

Lucy wants her plans kept with the code so the team can read them. She sets plansDirectory to docs/plans.

Why it matters

Plans in the repo can be read, reviewed and kept with the work they describe.

Definition

plansDirectory is a settings key that sets where Claude Code saves the plan files it writes in plan mode. The path is read from the project root. Left unset, plans go in ~/.claude/plans. If the path points outside the project root, Claude Code uses ~/.claude/plans instead.

Example code

json
{
  "plansDirectory": "docs/plans"
}
Keep plans in the repo, next to the docs.

Common mistake

Pointing it at a folder outside the repo, such as ../plans. Claude Code then falls back to ~/.claude/plans.

Key takeaways

  1. 1
    Where plans go. From plan mode.
  2. 2
    From the repo root. A path.
  3. 3
    Inside the repo. Or it falls back.