Skip to content

Add forkmind plugin — local-first LLM branching & debugging#285

Open
Medhovarsh wants to merge 1 commit into
ccplugins:mainfrom
Medhovarsh:add-forkmind
Open

Add forkmind plugin — local-first LLM branching & debugging#285
Medhovarsh wants to merge 1 commit into
ccplugins:mainfrom
Medhovarsh:add-forkmind

Conversation

@Medhovarsh

Copy link
Copy Markdown

Adds ForkMind to the marketplace.

ForkMind treats AI context windows like a Git repo: it captures every LLM call into a local .forkmind/ directory, visualizes the conversation as a DAG, and lets you branch alternative prompts/models from any historical turn. Free & local via Ollama, works with any OpenAI-compatible API, and ships an MCP server so agents can query their own history.

What this PR adds

  • plugins/forkmind/ — vendored plugin (.claude-plugin/plugin.json, skills/, commands/, agents/, README)
  • one entry in .claude-plugin/marketplace.json (category: Development Engineering)

The plugin bundles

  • forkmind skill — debug/compare/branch/regression
  • /forkmind command
  • forkmind-debugger agent — isolated model/prompt compares
  • MCP server, auto-wired (npx … forkmind mcp)

Links

Copilot AI review requested due to automatic review settings June 26, 2026 06:07

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds the ForkMind plugin to this repository’s Claude Code plugin marketplace, including a skill, slash command, subagent, and plugin manifest wiring for its MCP server.

Changes:

  • Added the ForkMind plugin package under plugins/forkmind/ (skill, command, agent, README, plugin manifest).
  • Registered ForkMind in .claude-plugin/marketplace.json under Development Engineering.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
plugins/forkmind/skills/forkmind/SKILL.md Adds the ForkMind skill definition and usage docs (run instructions, core workflows, MCP config).
plugins/forkmind/README.md Provides a short plugin overview and pointers to upstream docs/homepage.
plugins/forkmind/commands/forkmind.md Adds the /forkmind command wrapper guidance mapping arguments to skill usage.
plugins/forkmind/agents/forkmind-debugger.md Adds a forkmind-debugger subagent spec for isolated comparisons/regression checks.
plugins/forkmind/.claude-plugin/plugin.json Defines the plugin manifest and MCP server launch configuration.
.claude-plugin/marketplace.json Registers the new forkmind marketplace entry pointing at ./plugins/forkmind.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +22 to +28
| Situation | Why ForkMind |
|---|---|
| "This prompt sometimes regresses — catch it" | Pin baselines, re-run, diff drift |
| "Compare llama3 vs gpt-4o on the same turn" | Fork the node, swap model, re-run |
| "Why did the agent change its answer?" | Inspect the DAG: request/response, tokens, lineage |
| "Capture all LLM traffic during this task" | Point client at the proxy; everything is logged |
| Agent needs to recall its own past attempts | ForkMind MCP server exposes the history |
Comment on lines +86 to +87
- Everything is plain JSON on disk under `.forkmind/`. No database, no telemetry.
- Add `.forkmind/` to `.gitignore` (the repo already does for its own checkout).

```bash
# starts proxy + dashboard on :4500
npx github:medhovarsh/forkmind start
Comment on lines +7 to +9
- no args or `start` → tell the user how to launch ForkMind
(`npx github:medhovarsh/forkmind start`, proxy + dashboard on :4500) and how
to point their OpenAI-compatible client at `http://localhost:4500/v1`.
Comment on lines +7 to +10
pin/verify a regression baseline. Returns a compact verdict (winner, diffs,
drift) — not raw transcripts — so main context stays small.
tools: [Read, Bash, Glob, Grep]
---
Comment on lines +19 to +20
- Start it if not running: `npx github:medhovarsh/forkmind start` (proxy +
dashboard on `:4500`). Clients hit `http://localhost:4500/v1`.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants