edgebase bootstrapfor copy-focused, host-aware onboarding prompts.- Host capability table covering Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and Windsurf setup surfaces.
- Active Work Contract state at
.edgebase/session/active-goal.json, written by prompt hooks andedgebase goal --record. edgebase statusfor active goal, freshness, changed files, stale files, elevated tests, unrecorded required checks, and latest artifacts.edgebase finishfor writing.edgebase/passports/latest.mdand.jsonwithout inventing test results.- Codex global skill surfaces for
/edgebase,/edgebase-goal,/goal, and/edgebase-*commands when global setup is selected. - Marker-bounded
edgebase team init optional|requiredandedgebase team disable.
- Pre-edit hooks now use the persisted active Work Contract before falling back to preflight state.
- Claude pre-edit checks warn by default and support opt-in strict denial for missing/stale contracts or protected-path edits.
- Git freshness hooks now cover
post-commit,post-checkout,post-merge, andpost-rewrite. - Patch Passport output now separates inferred required checks from explicitly recorded tests.
edgebase install-prompt --agent <name>prints the copy/paste setup prompt for Claude Code, Codex, or all supported agent hosts.
- Generated hook commands and slash-skill fallback commands now use platform-aware quoting so Windows paths with spaces render with Windows-compatible double quotes while macOS/Linux keep POSIX quoting.
- MCP prompt command fallbacks now share the same platform-aware rendering as generated Claude Code and Codex skills.
- Codex hook setup now writes the current event-keyed
hooks.jsonshape, while preserving unrelated hooks and migrating Edgebase's older flat hook entries. fork-planno longer treats Edgebase's own local.edgebase/cache as a dirty user change aftercheckpoint.
- Advisory Change Blast Radius via
edgebase radius,edgebase_radius, and/edgebase-radius. - Goal Capsules now include a non-blocking Change Blast Radius section when a target file is known.
- Radius findings classify likely API routes, DB migration paths, focused tests, downstream modules, and side-effect risks with confidence and source.
- Planning guidance now treats blast radius as an impact map, not an instruction to edit every listed path.
- Project slash skills for normal Edgebase operations:
/edgebase-checkpoint,/edgebase-resume,/edgebase-fork-plan,/edgebase-passport,/edgebase-preflight-status,/edgebase-preflight-refresh,/edgebase-index,/edgebase-stats,/edgebase-doctor,/edgebase-setup,/edgebase-disable, and/edgebase-version. - MCP prompt aliases for the
/edgebase-*operational command set. - Graph lifecycle verification notes in
docs/GRAPH_VERIFICATION_0.1.7.md.
- Agent-facing docs now prefer slash commands for day-to-day Edgebase operations, with
python3 -m edgebase ...kept as the shell fallback.
- Branded
/edgebase-goal <goal>project skills for Claude Code and Codex, plus anedgebase-goalMCP prompt for clients that expose prompt menus. - Doctor checks and setup coverage for the new branded Goal Capsule command.
edgebase --versionfor quick installed-version checks.
/goal <goal>remains installed as a compatibility alias, while docs now lead with/edgebase-goalto make the command easier to associate with Edgebase.- Codex setup now skips unmarked existing project skills instead of aborting setup, matching the existing Claude Code preservation behavior.
- Edgebase logo and mark assets under
assets/. - GitHub Actions CI for Python 3.10 and 3.12.
- GitHub issue templates and pull request template.
- Launch post draft in
docs/LAUNCH_POST.md.
- README first screen now uses the logo, badges, a clearer product promise, and a concise "What It Does" section.
- Package description now matches the product positioning: git-native preflight context for coding agents.
- README and agent-client docs now lead with a universal paste-into-any-agent install prompt instead of a human-run
edgebase setupcommand. - Added
docs/UNIVERSAL_AGENT_PROMPT.mdas the standalone install prompt for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Windsurf, and other shell-capable coding agents.
- Goal Capsules with
edgebase goal,edgebase_goal, and MCP promptgoal. - Pre-edit Work Contracts for Claude Code Write/Edit/MultiEdit hooks.
- Patch Passports with
edgebase passportfor changed files, evidence, explicit tests, risk, and review focus. - Claude Code project skill
/goal <goal>. - Local
.edgebase/graphs/latest.html,.json, and.dotartifacts refreshed by hooks and MCP calls for optional visual inspection. - Edgebase Preflight Gate: Claude Code
UserPromptSubmit,PreToolUse,PostToolUse,PreCompact, andSessionEndhooks now record a Goal Capsule before planning, block broad edits when the capsule is missing or stale, refresh after edits, checkpoint before compaction, and save a Patch Passport at session end. - Codex project setup now writes MCP config,
[features] hooks = true,.codex/hooks.json, and project skills under.agents/skills/edgebaseand.agents/skills/goal. - Context branch commands and MCP tools:
edgebase checkpoint,edgebase fork-plan,edgebase resume,edgebase_checkpoint,edgebase_fork_plan, andedgebase_resume. edgebase preflight statusandedgebase preflight refreshfor inspecting or manually refreshing the edit gate.
- Claude Code PostToolUse refresh now reports an edit delta with impacted files, checks, and unverified related context.
- Documentation now positions Goal Capsules as the executable work-contract surface.
edgebase setupandedgebase doctornow validate automatic preflight integrations for both Claude Code and Codex instead of relying on users to ask foredgebase_context.
- Claude Code
UserPromptSubmithook that injects compact Edgebase context automatically for likely coding prompts. - Claude Code project skill
/edgebase <task>for explicit context refresh without memorizing MCP tool syntax. - MCP prompt named
edgebasefor clients that expose prompt or slash-command style MCP surfaces.
- Setup and docs no longer tell users to paste "Use edgebase_context" before each task.
- Agent instructions now tell agents to use Edgebase automatically when broad structural context is needed.
- Setup now adds
.edgebase/to the local git exclude file instead of dirtying fresh repos with cache files. - Generated git and Claude hook commands now use shell-safe quoting for repository paths.
- MCP server version now follows the package version.
- Production setup diagnostics with
edgebase doctor. - Reversible integrations with
edgebase disable. - Marker-bounded
AGENTS.mdinstructions for automatic agent adoption. - More complete agent client documentation for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and Windsurf.
- MCP configs now default to the Python interpreter that ran setup, avoiding GUI PATH issues.
- Claude Code PostToolUse refresh runs asynchronously.
- CLI
--rootworks before or after the subcommand.
- Local SQLite graph index for source files, symbols, imports, call edges, tests, owners, commits, churn, confidence, and freshness.
edgebase_contextMCP tool for compact source-backed task context.- CLI commands for setup, indexing, context capsules, MCP stdio serving, diagnostics, benchmarks, and disabling integrations.
- Agent setup support for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and Windsurf.
- Claude Code SessionStart and async PostToolUse freshness hooks.
- Validation harness and documentation for benchmark-driven adoption.