Quickstart

Alpha status: the current transport slice is published as grape-context@0.1.0-alpha.3. It requires Node.js 22.13+.

For reproducible alpha.3 testing:

npm install -g grape-context@0.1.0-alpha.3
grape init --connect

The normal alpha install path is:

npm install -g grape-context
grape init --connect

grape init --connect creates .grape/, applies local SQLite migrations, captures the initial Git snapshot, reports scan diagnostics, and prints MCP integration guidance plus an agent instruction block you can paste into Cursor, Claude Code, or other MCP clients.

An MCP-capable coding agent then requests context through:

grape_get_context

Grape only omits context already sent to the same session. If the MCP client changes session ID, Grape resends rather than unsafe-omit. Restore is session-bound. Branch, source, and dependency changes may invalidate prior sent context.

For continued turns, keep the same task/query and session identity. The alpha.3 session contract is strict by design: different task wording with the same explicit session is a mismatch, and derived MCP sessions change when the query changes. See Agent Sessions for examples and recovery paths.

CLI And MCP

Manual CLI commands are debugging and fallback surfaces:

grape compile --task "Explain the files I need to edit"
grape compile --task "Explain the files I need to edit" --token-budget 4000
grape artifacts
grape artifacts --artifact <id>
grape proofs
grape proofs --proof <id>
grape claims --active
grape sessions
grape status
grape doctor
grape mcp --print-config
grape mcp --stdio
grape omitted --session <id>
grape omitted --session <id> --token <restoreToken>
grape stale
grape conflicts
grape conflicts --resolve <edge_id> --as coexists_with
grape run --session <id> -- <cmd...>
grape test --session <id> -- <cmd...>
grape bench --fixture clean-typescript-app
grape bench --fixture branch-switch-typescript-app
grape bench --fixture stale-source-typescript-app
grape bench --fixture session-reset-typescript-app

MCP exposes the same local transport path through grape mcp --stdio. Read tools include context retrieval, artifacts, claims, proofs, rules, omitted restore, stale items, conflicts, and status. Restricted write tools can record temporary candidates, command/test observations, user decisions, and confirmation requests, but they cannot promote durable truth directly.

If npm appears to keep older alpha code after installing alpha.3, clear the cache and reinstall the exact package:

npm cache clean --force
npm install -g grape-context@0.1.0-alpha.3