context_forge

context_forge

A Claude Code plugin that combines two things:

1. Token-waste reduction — 15 skills, a diagnostic agent, a session-start hook, and a live status line showing context usage.
2. DB-backed project scaffolding — /scaffold, /changelog, /sync-template slash commands plus an MCP server (forge-db) that stores templates, file content, and pinned dependency versions in Postgres so the model never invents them.

---

Skills

Skill	What it does
optimize-claudemd	Compresses bloated CLAUDE.md — cuts 40–80% of tokens loaded every session
low-token-mode	Switches Claude to terse response style — cuts reply tokens by 30–50%
reset-context	Safely resets context window when near full — prevents hard stops
tune-settings	Diffs and applies token-saving settings (autoLoadMemory, autoLoadSkills, etc.)
manage-skills	Audits loaded skills, disables unused ones — reduces session overhead
project-isolation	Scopes skills and hooks to current project only
estimate-tokens	Estimates tokens in any file before loading it
auto-compact	Configures compactOnContextFull — auto-compacts instead of stopping
settings-diff	Shows before/after diff before writing any settings change
check-claudemd-size	Reports CLAUDE.md word/token count with color-coded warnings
token-statusline	Adds live context bar to Claude Code status line
debug-hooks	Diagnoses broken hook configurations with detailed validation output
task-brain-lite	Decomposes complex tasks into prioritized, dependency-aware subtasks
llm-wiki	Builds a persistent wiki Claude references instead of re-reading raw docs — up to 96% token savings on repeated knowledge
forge-changelog	Reads the forge changelog and runs the template back-mapping loop (wraps forge-db MCP tools get_changelog, compute_suggestions, apply_suggestion)

Agent: hook-error-fixer — diagnoses and auto-fixes broken hook configurations.

Hook: Session-start script that warns when CLAUDE.md exceeds size thresholds.

Status line:

ctx [████████░░] 82%  │  md:~650t

---

Forge — DB-backed scaffolding

Three slash commands backed by the forge-db MCP server:

Command	What it does
/scaffold	Create a project from a template stored in Postgres
/changelog	Show recorded file/dependency changes for a project
/sync-template	Review recurring manual additions and fold them back in

Why facts live in Postgres: templates, file contents, and exact dependency versions are read verbatim from the DB through MCP tools. The model copies — it does not invent template names or guess versions — and scaffolds run a real typecheck/build before being declared good. Retrieval + validation instead of fine-tuning.

A PostToolUse hook (record-change.mjs) appends every Write / Edit to the changelogs table; /sync-template later analyses those rows and suggests template improvements.

Forge setup

# 1. Install MCP server deps
cd mcp && npm install && cd ..

# 2. Point at your remote Postgres
export FORGE_DATABASE_URL="[REDACTED:DB Connection String]

# 3. Create the schema (and an example template to test with)
psql "$FORGE_DATABASE_URL" -f mcp/db/schema.sql
psql "$FORGE_DATABASE_URL" -f mcp/db/seed-example.sql

.mcp.json reads ${FORGE_DATABASE_URL} from your environment, so make sure that variable is exported in the shell where you launch Claude Code. Without it, the forge half is inert — the token-saver half keeps working.

MCP tools (forge-db)

list_templates, get_template, register_project, record_change, get_changelog, compute_suggestions, apply_suggestion.

---

Requirements

• Claude Code v2.1.97 or later (for refreshInterval support)
• python3 — used by the token status line script and hook validation
• node ≥ 18 — runs the MCP server and the record-change hook
• Postgres reachable via $FORGE_DATABASE_URL (forge half only — token-saver half does not need it)

---

Installation

Option A — Clone directly into Claude plugins

git clone https://github.com/kyuna0312/context_forge.git ~/.claude/plugins/context_forge

Option B — Clone anywhere, load with --plugin-dir

git clone https://github.com/kyuna0312/context_forge.git ~/context_forge
claude --plugin-dir ~/context_forge

Option C — Use the install script

git clone https://github.com/kyuna0312/context_forge.git ~/context_forge
bash ~/context_forge/scripts/install.sh

The install script symlinks the plugin into ~/.claude/plugins/context_forge.

Option D — Use in place (Desktop)

claude --plugin-dir ~/Desktop/context_forge

---