@co-syn/forest

Bridge your Claude Code sessions with your team. Share context, sync plans, track tasks — one command to set up.

Quick start

npx @co-syn/forest init --token forestpat_YOUR_TOKEN

That's it. This registers the MCP server, configures the plan sync hook, and saves your credentials.

What it does

MCP Tools (Claude calls these)

| Tool | Description | |------|-------------| | forest_sync | Share a summary of your session with the team via Slack | | forest_tasks | List active tasks from Forest | | forest_update | Update a task's status or add notes |

Plan Sync Hook (automatic)

When you exit plan mode in Claude Code ("Accept Edits"), the plan markdown is automatically sent to Forest. From there, Forest can:

• Match the plan to active tasks
• Post to your team's Slack channel
• Update project context

Setup

1. Get your token

Generate a personal API token from the Forest web app settings page.

2. Run init

npx @co-syn/forest init --token forestpat_YOUR_TOKEN

For a custom backend URL:

npx @co-syn/forest init --token forestpat_YOUR_TOKEN --api-url https://your-backend.example.com

3. Use it

In Claude Code, just ask naturally:

• "sync what we did to the team"
• "share this with @john on #engineering"
• "show me active tasks"
• "mark the auth task as done"

Plans sync automatically when you accept edits from plan mode — no action needed.

How it works

npx @co-syn/forest init
  ├── Saves token to ~/.config/forest/config.json
  ├── Registers MCP server with Claude Code
  └── Adds ExitPlanMode hook to ~/.claude/settings.json

During a session:
  Claude Code ←─stdio──→ forest mcp (MCP server, local process)
                              │
                         HTTPS + Bearer token
                              │
                              ▼
                     Forest Backend (your org)
                        ├── Slack
                        ├── Tasks DB
                        └── Normalized Events

On "Accept Edits":
  ExitPlanMode hook fires → forest hook plan-exit
    → reads transcript → extracts plan markdown
    → POST /mcp/plan to Forest backend

Local development

npx @co-syn/forest init --token forestpat_YOUR_TOKEN --api-url http://localhost:8787

Or run the MCP server directly:

FOREST_API_TOKEN=forestpat_... FOREST_API_URL=http://localhost:8787 node packages/forest-mcp/build/mcp.js

CLI reference

npx @co-syn/forest init --token <token>   # Set up everything
npx @co-syn/forest mcp                    # Start MCP server (used by Claude Code)
npx @co-syn/forest hook plan-exit         # Run plan-exit hook (used by Claude Code)