[FEATURE] Add planStorage setting to configure plans directory location
Resolved 💬 3 comments Opened Dec 3, 2025 by uptownhr Closed Dec 6, 2025
Feature Request
Add a planStorage setting to settings.json that allows users to configure where plan files are stored.
Current Behavior
Plan mode creates files in ~/.claude/plans/ (global home directory) with no option to change this location.
Requested Behavior
Add a planStorage setting in settings.json with options:
{
"planStorage": "project" // or "global" (default)
}
"project": Store plans in.claude/plans/within the current project directory"global": Store plans in~/.claude/plans/(current default behavior)
Use Cases
- Project-specific context: Plans are often tightly coupled to the project being worked on. Storing them in the project directory keeps related artifacts together.
- Version control: Teams may want to commit plans to track planning decisions alongside code.
- Multi-project workflows: When working across multiple projects, having plans in each project directory prevents confusion about which plan belongs where.
- Privacy/isolation: Some projects may have sensitive planning information that shouldn't be mixed with other project plans.
Alternative Considered
A more flexible approach could accept a path:
{
"planStorage": ".claude/plans" // relative to project root
}
Or support both project and global settings levels, where project-level settings.json can override the global default.
Related
- Issue #12366 mentions this concern: "Plans should be stored in project .claude dir IMHO"
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗