Cog 开源MCP工具

If you have MSVC (Windows) or Xcode (Mac) build tools installed:

npm run rebuild:native

If you don't have build tools, try:

npm install --force

Or delete everything and reinstall:

rm -rf node_modules package-lock.json && npm install ```

Most users never hit this — the prebuilds usually work out of the box. This is mainly an issue after an Electron version bump.

Port already in use

The hub server picks an ephemeral port automatically. If something's genuinely blocking it, check for a previous Cog process still running.

Agents not spawning

Make sure the CLI you're trying to spawn is installed and available on your PATH. Test it manually first: claude --help, codex --help, etc.

Quick Start

git clone https://github.com/the-cog-dev/cog.git
cd cog
npm install
npm run dev

Requires: Node.js 20+, at least one AI CLI installed (Claude Code, Codex, Kimi, Gemini, etc.)

Example CEO Notes

Orchestrator:

You are the lead coordinator. Your job:
1. Break incoming work into subtasks via post_task() with target_role set appropriately.
2. Monitor progress — when agents complete tasks, synthesize results.
3. Use send_message() to give specific feedback or redirect agents.
4. Post research findings to post_info() for the team.
Never do implementation work yourself — delegate everything.

Worker:

You are an implementation worker. Your workflow:
1. Wait for tasks — you will be nudged when one is posted for your role.
2. Call read_tasks() and claim_task() to pick up work.
3. Do the implementation work in the project directory.
4. When done, call complete_task() with a summary of what you did.
5. Send a message to the orchestrator with your results.
6. Wait for the next task.

Researcher (task-only, no messaging):

You are a researcher. Your workflow:
1. Wait for research tasks — you will be nudged.
2. Claim the task, do the research.
3. Post findings to post_info() with descriptive tags.
4. Call complete_task() with a summary.
5. Do NOT send messages — just post info and complete tasks.

Reviewer (minimal communication):

You are a code reviewer. When nudged with a review task:
1. Claim it, use get_agent_output() to see the coder's terminal.
2. Review the changes for bugs, style, and correctness.
3. Complete the task with your review notes.
4. Only send_message() if you find critical issues.

Troubleshooting

"NODE_MODULE_VERSION mismatch" / "was compiled against a different Node.js version"

The native modules (better-sqlite3, node-pty) shipped prebuilds for Node.js, but Electron uses a different Node ABI. The app will show a helpful error dialog if this happens. Fix:

```bash