forgeoptimizer 1.0.0

Forge — AI optimization runtime. Fast prompt and token optimization for Claude Code, Codex, Cursor, OpenCode, and CommandCode CLI.

Forge

Forge is an AI optimization runtime. It prepares your repository context at light speed — prompt optimization and token compression — then launches the AI CLI you already use.

Install:

uv tool install forgectx

The command is forge.

What it does

When you run forge claude, forge codex, forge cursor, forge opencode, or forge commandcode, Forge:

1. Detects your git repository (or current directory)
2. Builds a shallow repo snapshot — it does not index your whole codebase
3. Runs prompt optimization (Ponytail ruleset) and token compression
4. Reuses cached results when nothing important changed
5. Launches the selected CLI with FORGE_CONTEXT and FORGE_CONTEXT_FILE set

Wrappers feel instant because Forge skips full graph builds during normal use.

Commands

Command	Description
forge claude	Launch Claude Code with optimized context
forge codex	Launch Codex CLI with optimized context
forge cursor	Launch Cursor CLI with optimized context
forge opencode	Launch OpenCode CLI with optimized context
forge commandcode	Launch CommandCode CLI with optimized context
forge graph build	Optionally build a full knowledge graph via Graphify
forge --version	Show version

Pass through any flags your CLI supports:

forge claude -- "fix the failing test in tests/test_foo.py"
forge codex --help
forge cursor --refresh

Use --refresh to bypass Forge's context cache.

Optional: knowledge graph

If you want a full codebase knowledge graph (separate from the fast wrapper path):

uv tool install graphifyy
forge graph build

Graphify runs only when you ask for it — not on every forge claude / codex / cursor invocation.

Environment variables

Wrappers export:

Variable	Purpose
FORGE_CONTEXT	Optimized text context
FORGE_CONTEXT_FILE	Path to the optimized context file
FORGE_REPO_ROOT	Detected repository root

Development

git clone https://github.com/mdshzb04/ForgeCli
cd ForgeCli
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest
ruff check forgecli tests

Release

Push a version tag to publish to TestPyPI and PyPI:

git tag v1.0.0
git push origin v1.0.0

Publish jobs run only on v* tags. On regular pushes to main, those jobs show as Skipped — that is expected, not a failure.

Configure GitHub environments testpypi and pypi with PyPI trusted publishing for package name forgectx.

---

License

MIT