Skip to content

v0.6.2 — ckg setup (agent auto-configuration)

Choose a tag to compare

View all tags
@kjoshi07 kjoshi07 released this 27 Jun 10:00
· 5 commits to main since this release
v0.6.2
a54800b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

agentforge-graph 0.6.2 — one command to wire the graph into your agent

Theme: adoption. 0.6 made it easy to build an org-scale code graph; 0.6.2
makes it easy to connect one. New ckg setup writes your coding agent's
MCP config for you — no hand-editing JSON — and (with --hooks) nudges the agent
to actually use the graph.

Highlights

ckg setup — agent auto-configuration (feat-013)

ckg setup            # detect agent → show a diff → confirm → write .mcp.json → connection check
ckg setup --print    # dry-run
ckg setup --hooks    # also add the "prefer the graph" nudge to AGENTS.md/CLAUDE.md
ckg setup --undo     # reverse everything it wrote
  • Repo-level by default — writes a committable <repo>/.mcp.json (the
    portable MCP standard, read by Claude Code and other clients). Commit it and
    the whole team's agents are wired. --scope user writes the global
    ~/.claude.json instead.
  • Safe on files you didn't author — edits are structural (never text
    splicing), marked (_managed_by: agentforge-graph), idempotent, and
    conflict-safe: a ckg entry you wrote is never clobbered without
    --force. Everything is reversible with --undo.
  • Connection check — after writing, it spawns the server and confirms the
    agent can reach it (connected ✓).
  • --hooks — appends a short, non-blocking nudge block to
    AGENTS.md/CLAUDE.md so the agent prefers the ckg_* tools over grep/glob.
  • Extensible — new agents register via the
    agentforge_graph.agent_adapters entry-point group (Claude Code built in).

Frictionless first run (FA-001 Phase 1)

  • Try it with zero install: uvx agentforge-graph index . /
    pipx run agentforge-graph serve-mcp --repo ..
  • ckg --version now reports how it was launched, e.g. ckg 0.6.2 (uvx).

See the new guide: Agent auto-configuration.

Validation

  • Gate: ruff + ruff format + mypy --strict clean; 903 passed / 45
    skipped, 94.71% coverage    .
  • Live end-to-end: a real MCP client (mcp SDK) connected to a spawned
    ckg serve-mcp → 10 tools; project/user scope, --hooks, conflict/--force,
    idempotency, and --undo exercised against a real repo; the uvx trial path
    verified from a built wheel.

Install / upgrade

pip install -U agentforge-graph        # 0.6.2
ckg --version                          # ckg 0.6.2 (pip)

No index-schema change — existing .ckg/ indexes are unaffected.

Full changelog

See CHANGELOG.md.

Assets 2
Loading