The first major refresh in nine months. Context-forge now generates everything a modern (May 2026) Claude Code project expects — and the init wizard is a full-screen Ink TUI.

For the full ledger of what changed, see CHANGELOG.md.

• Less yak-shaving. Scaffolds the entire .claude/ surface — settings, agents, skills, hooks, slash commands — in one command. No copy-pasting frontmatter, no hunting for the right schema URL.
• Better Claude context. Generates a tech-stack-aware CLAUDE.md, staged Docs/Implementation.md, and feature-specific PRPs (optionally AI-enhanced) so Claude Code knows your codebase from turn one.
• Modern Claude Code surface, out of the box. Tracks the May 2026 conventions (settings.json hooks, agents, skills, slash-commands-as-files). Upgrade once, ship everywhere.
• Multi-IDE. Same project context, seven IDEs: Claude · Cursor · Windsurf · Cline · Roo · Gemini · Copilot.
• Free and offline-capable. AI-powered PRP generation is optional; the deterministic template path works fully offline.
• Adapter-clean. Every IDE has its own adapter; every generator returns the same GeneratedFile[] shape. Easy to extend.

The modern .claude/settings.json + agents + skills surface is Claude-specific today. Every other IDE gets the universal artifacts — CLAUDE.md-equivalent, PRPs/, and the IDE's native config files. See docs/ide-configs/ for per-IDE deep dives.

npm install -g context-forge
context-forge init

You'll land in the Ink TUI:

┌─ context-forge · init ───────────────────────────────────────────────┐
│                                                                      │
│  Welcome to context-forge                                            │
│                                                                      │
│  Let's set up Claude-current AI development context for your project.│
│                                                                      │
│  This wizard takes ~60 seconds. ESC = back, Enter = continue.        │
│                                                                      │
│  [ Continue → ]                                                      │
│                                                                      │
└──────────────────────────────────────────────────────────────────────┘

For CI / non-TTY / scripts, opt out of the TUI:

context-forge init --no-tui                        # inquirer fallback
context-forge init --config ./context-forge.json   # fully scripted

• Node.js 18+ and npm 7+
• A code editor (VS Code recommended for the modern Claude Code surface)

Install globally, not as a project dependency — context-forge is a CLI, not a library.

A typical Claude-target init produces:

my-project/
├── CLAUDE.md                         # Tech-stack-aware project rules
├── Docs/
│   ├── Implementation.md             # Staged dev plan (Stage 1–4)
│   ├── project_structure.md          # Folder organization
│   ├── UI_UX_doc.md                  # Design spec (if applicable)
│   └── Bug_tracking.md               # Bug-log template
├── PRPs/
│   ├── <project>-prp.md              # Base implementation PRP
│   ├── <project>-planning.md         # Architecture PRP (enterprise/team)
│   └── <feature>-prp.md              # One per must-have feature
├── ai_docs/
│   └── README.md                     # Optional AI-curated docs
├── .claude/
│   ├── settings.json                 # ← NEW v4.0.0 — schema-locked, full surface
│   ├── agents/                       # ← NEW v4.0.0
│   │   ├── code-reviewer.md
│   │   ├── test-runner.md
│   │   ├── plan-architect.md
│   │   ├── security-auditor.md
│   │   └── prp-executor.md
│   ├── skills/                       # ← NEW v4.0.0
│   │   ├── testing-protocol/SKILL.md
│   │   ├── deployment-checklist/SKILL.md
│   │   └── codebase-navigation/SKILL.md
│   ├── commands/                     # 21 .md files with frontmatter
│   │   ├── PRPs/        (5)
│   │   ├── orchestration/ (4)
│   │   ├── checkpoints/ (3)
│   │   ├── quality/     (3)
│   │   ├── session/     (3)
│   │   └── migration/   (3)
│   └── hooks/                        # Scripts registered via settings.json
│       ├── pre-tool-use.sh
│       ├── post-tool-use.sh
│       ├── session-start.sh
│       ├── user-prompt-submit.sh
│       ├── pre-compact.sh
│       ├── stop.sh
│       ├── subagent-stop.sh
│       ├── notification.sh
│       ├── lint-on-edit.sh
│       └── prp-tracking.py           # (Python only where it earns its keep)
└── .context-forge/
    └── config.json                   # Replay-the-init record

Toggle generators individually via the TUI's Options screen, or with config.extras.{claudeSettings, agents, skills, hooks, claudeCommands, prp, validation, aiDocs, docker, cicd}.

Tech-stack-aware project rules — KISS/YAGNI directives, code structure limits, testing requirements, pre-commit checklist, and a tech-stack-specific section pulled from templates/claude/tech-stacks/. Always emitted.

Staged development plan (Implementation.md), folder organization (project_structure.md), UX spec (UI_UX_doc.md), and a bug-log template (Bug_tracking.md). Emitted unless explicitly disabled.

Product Requirement Prompts — Andre Karpathy-style implementation blueprints with validation gates. One base PRP plus one per must-have feature. Optionally AI-enhanced (see AI-powered PRPs). Opt out via extras.prp: false.

Emitted by src/generators/claudeSettings.ts. One canonical file wiring the full modern surface:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-opus-4-7",
  "hooks": {
    "PreToolUse":      [{ "matcher": "Bash|Edit|Write", "hooks": [{ "type": "command", "command": "./.claude/hooks/pre-tool-use.sh" }] }],
    "PostToolUse":     [{ "matcher": "Edit|Write",      "hooks": [{ "type": "command", "command": "./.claude/hooks/lint-on-edit.sh" }] }],
    "PreCompact":      [{ "hooks": [{ "type": "command", "command": "./.claude/hooks/pre-compact.sh" }] }],
    "SessionStart":    [{ "hooks": [{ "type": "command", "command": "./.claude/hooks/session-start.sh" }] }],
    "UserPromptSubmit":[{ "hooks": [{ "type": "command", "command": "./.claude/hooks/user-prompt-submit.sh" }] }],
    "Stop":            [{ "hooks": [{ "type": "command", "command": "./.claude/hooks/stop.sh" }] }],
    "SubagentStop":    [{ "hooks": [{ "type": "command", "command": "./.claude/hooks/subagent-stop.sh" }] }],
    "Notification":    [{ "hooks": [{ "type": "command", "command": "./.claude/hooks/notification.sh" }] }]
  },
  "mcpServers": {
    "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "{{CWD}}"] }
  },
  "statusLine":   { "type": "command", "command": "./.claude/statusline.sh" },
  "outputStyles": { "default": "concise" },
  "permissions":  { "allow": ["Bash(git status:*)", "Bash(npm test:*)"], "deny": ["Bash(rm -rf /:*)"] }
}

Opt out via extras.claudeSettings: false. Override individual fields with the preferredModel, mcpServers, statusLine, outputStyles, permissionsAllow, permissionsDeny fields on ProjectConfig.

Emitted by src/generators/agents.ts. One .md file per sub-agent with frontmatter:

---
name: code-reviewer
description: Reviews recent edits for style, security, and convention adherence.
tools: ["Read", "Grep", "Glob", "Bash(git diff:*)", "Bash(git log:*)"]
model: claude-opus-4-7
---

# Code Reviewer

You are invoked when the user wants a careful second pass over recent changes…

Five defaults ship; add your own via customAgents on ProjectConfig. Opt out via extras.agents: false.

Emitted by src/generators/skills.ts. One <name>/SKILL.md per skill with frontmatter (name, description, when_to_use) and a Handlebars-rendered body. Auto-derives {{testCommand}}, {{testFramework}} (Jest / Vitest / Pytest / JUnit / RSpec), {{primaryLanguage}}, and {{deployTarget}} from your tech stack.

Three defaults ship; add your own via customSkills on ProjectConfig. Opt out via extras.skills: false.

Emitted by src/generators/slashCommands.ts. 21 commands as real .md files with full frontmatter:

---
allowed-tools: [Bash, Read, Grep]
argument-hint: "<feature-name>"
description: "Generate a comprehensive Product Requirement Prompt for a new feature."
model: claude-opus-4-7
---

# PRP create — $1

Compose a Product Requirement Prompt for the feature **$1**…

The legacy renderCommandsForClaudeMd(config) export is retained for projects that embed the command list directly in CLAUDE.md.

Emitted by src/generators/hooks.ts, enhancementHooks.ts, and migrationHooks.ts. Scripts live in .claude/hooks/; registration happens via settings.json's hooks block (not via the old .claude/hooks.yaml convention). Every script is chmod 0o755 automatically.

14 bash + 4 Python. Python is retained only where stdin-JSON or markdown scanning truly warrants it: prp-tracking.py, dart-progress-updater.py, auto-task-commenter.py, task-code-mapper.py.

Dropped: ContextRotation.py — subsumed by pre-compact.sh's snapshot strategy.

Optional. When enabled with --ai-prp (or via the TUI), context-forge calls Anthropic or OpenAI to produce feature-specific PRPs containing implementation strategy, gotchas, best practices, validation approach, and curated documentation links — instead of generic template placeholders.

context-forge ai-keys --provider anthropic   # one-time setup, AES-256-CBC encrypted at ~/.context-forge-keys
context-forge init --ai-prp                  # then init normally

Falls back to deterministic templates on 30-second timeout. AI calls go through the @anthropic-ai/claude-code query() wrapper today; v4.1.0's W11 task will switch the AI paths to direct @anthropic-ai/sdk messages.create calls to unlock prompt caching and extended thinking.

21 commands across 6 subdirs, each emitted as .claude/commands/<subdir>/<name>.md with frontmatter:

The full bodies live in your generated .claude/commands/ directory — open them, edit them, commit them.

Five default sub-agents land in .claude/agents/:

Each is one .md file with YAML frontmatter (name, description, tools, model) plus a system-prompt body. Customize via customAgents on ProjectConfig.

Three default skills land in .claude/skills/<name>/SKILL.md:

Customize via customSkills on ProjectConfig.

All 8 Claude Code lifecycle events are wired through settings.json. Scripts live in .claude/hooks/.

Enhancement and migration workflows extend this set with prp-tracking.py, dart-progress-updater.py, auto-task-commenter.py, task-code-mapper.py, plus several phase-specific bash hooks.

context-forge init runs as a 10-screen full-screen wizard. ESC = back, Enter = advance, Ctrl-C = clean exit.

1.  Welcome              7.  PRP & Options
2.  Project name         8.  Confirm
3.  Description          9.  Generating (live ProgressList)
4.  Tech stack           10. Done — next-steps screen
5.  Features
6.  IDE targets

┌─ context-forge · tech stack ─────────────────────────────────────────┐
│                                                                      │
│  Frontend                                                            │
│   ◉ Next.js 15        ○ Nuxt 4         ○ React (Vite)               │
│   ○ Vue 3             ○ Angular        ○ Vanilla                    │
│                                                                      │
│  Backend                                                             │
│   ○ FastAPI           ◉ Express        ○ Django                     │
│   ○ Spring Boot       ○ Rails          ○ None                       │
│                                                                      │
│  Database                                                            │
│   ◉ PostgreSQL  ○ MySQL  ○ MongoDB  ○ SQLite  ○ Redis               │
│                                                                      │
│  [ ← ESC back ]                                  [ Enter → next ]    │
└──────────────────────────────────────────────────────────────────────┘

The Generating screen renders a live ProgressList — one line per generator running in real time (CLAUDE.md → Docs → PRPs → settings.json → agents → skills → commands → hooks → IDE adapters).

Status of other commands: Only init has the Ink TUI in v4.0.0. analyze, enhance, and migrate still use inquirer; an Ink TUI for each is on the v4.1.0 roadmap.

Replays your last init exactly. Commit it; future init runs against the same project re-use the answers.

{
  "projectName": "Analytics Dashboard",
  "projectType": "fullstack",
  "description": "Real-time analytics dashboard",
  "techStack": {
    "frontend": "nextjs",
    "backend": "fastapi",
    "database": "postgresql",
    "auth": "jwt"
  },
  "features": [
    { "id": "auth", "name": "User Authentication", "priority": "must-have", "complexity": "medium" }
  ],
  "preferredModel": "claude-opus-4-7",
  "testCommand": "npm test",
  "deployTarget": "vercel",
  "extras": {
    "prp": true,
    "validation": true,
    "claudeSettings": true,
    "agents": true,
    "skills": true,
    "hooks": true,
    "claudeCommands": true,
    "docker": true,
    "cicd": true
  }
}

Run with context-forge init --config ./context-forge.json.

Holds AI provider settings (model overrides, timeouts). Edit via context-forge config. The 2026 model lineup context-forge defaults to:

• DEBUG=1 — prints stack traces on error.
• ANTHROPIC_API_KEY / OPENAI_API_KEY — bypass the encrypted store and read directly from env.
• CONTEXT_FORGE_TEMPLATES_DIR — point at a custom templates directory (defaults to ~/.context-forge/templates/).

Context-forge speaks every IDE's native config format. Same ProjectConfig, seven outputs. Pick one or all via the TUI's IDE targets screen, or via --ide claude,cursor,windsurf on the CLI.

For per-IDE shape (PRP layout, MDC conventions, workflow files), see:

• Claude Code
• Cursor
• Windsurf
• Cline
• Roo Code
• Gemini
• GitHub Copilot

Plus the deep-dive Claude Code feature guides:

• Slash Commands Reference
• PRP Runner Guide
• Enhanced PRP Templates
• Orchestration Workflow
• Dart Integration

Tracked in CHANGELOG.md under "v4.1.0 backlog":

• W11 — Direct SDK paths for AI features. Migrate AIIntelligenceService.generateFeaturePRP and generateSmartDefaults from the @anthropic-ai/claude-code query() wrapper to direct @anthropic-ai/sdk messages.create calls. Unblocks prompt caching (5-minute TTL on large system prompts) and extended thinking (thinking: { type: "enabled", budget_tokens: 4000 }).
• Ink TUIs for analyze / enhance / migrate. Currently only init is wizard-driven.
• @anthropic-ai/claude-code 2.x migration. Depends on W11 — the 2.x line is CLI-only (no programmatic query() export).
• Plugins. .claude/plugins.json scaffolding for the Claude Code plugin marketplace.

Contributions welcome. Until a CONTRIBUTING.md lands, the short version:

1. Fork → feature branch from main.
2. npm install · npm run build · npm test · npm run lint — all must pass.
3. New tech stack? Drop a template under templates/claude/tech-stacks/ and wire it into the stack registry.
4. New IDE? Extend IDEAdapter in src/adapters/, implement generateFiles(), register in the adapter factory.
5. New generator? Return GeneratedFile[] from a function in src/generators/, then wire it into src/generators/index.ts and the relevant adapter.

Open an issue first for non-trivial work so we can align on scope.

This project stands on the shoulders of:

• Rasmus Widing (Wirasm) — PRPs-agentic-eng, the foundation for our PRP system and validation loops.
• Andre Karpathy — context engineering principles that shaped this tool.
• Anthropic — Claude Code itself, the SDK, and the modern .claude/ surface this tool generates.
• AILABS (@AILABS-393) — excellent educational content on AI-assisted development workflows.
• Dynamous.ai Community — pioneering work in AI-assisted development.

• Commander.js — CLI framework
• Ink — the TUI wizard for init
• Inquirer.js — the --no-tui fallback
• Handlebars — template engine
• @anthropic-ai/sdk + @anthropic-ai/claude-code — the Claude side

MIT — see LICENSE.

• Repository: github.com/webdevtodayjason/context-forge
• npm: npmjs.com/package/context-forge
• Issues: GitHub Issues
• Discussions: GitHub Discussions