Trace

Meta-orchestration layer for AI coding tools. Trace provides an MCP (Model Context Protocol) server that helps AI assistants like Claude Code and OpenCode manage projects, tasks, and features.

Installation

Quick Install (Interactive)

npx @ahmed-chouaya/trace

This will launch an interactive installer that asks:

1. Which runtime to install for (Claude Code, OpenCode, or both)
2. Where to install (globally for all projects, or locally for this project only)

Non-Interactive Install

You can skip the prompts using flags:

# Install for Claude Code globally
npx @ahmed-chouaya/trace --claude --global

# Install for OpenCode locally
npx @ahmed-chouaya/trace --opencode --local

# Install for both globally
npx @ahmed-chouaya/trace --both --global

Options

| Flag | Short | Description | |------|-------|-------------| | --claude | -c | Install for Claude Code | | --opencode | -o | Install for OpenCode | | --both | -b | Install for both Claude Code and OpenCode | | --global | -g | Install globally (all projects) | | --local | -l | Install locally (this project only) | | --help | -h | Show help message |

After Installation

1. Restart your AI tool (Claude Code or OpenCode) to load the new MCP server
2. The Trace tools will automatically be available in your AI assistant

What Gets Installed

The installer adds Trace to your MCP server configuration:

• Claude Code Global: ~/.claude/settings.local.json
• Claude Code Local: ./.claude/settings.local.json
• OpenCode Global: ~/.opencode/mcp.json
• OpenCode Local: ./.opencode/mcp.json

Available Tools

Once installed, Trace provides the following MCP tools to your AI assistant:

• trace_init - Initialize a new Trace project
• trace_get_project - Get project information and status
• trace_create_feature - Create a new feature
• trace_update_feature - Update feature status
• trace_create_task - Create a new task within a feature
• trace_update_task - Update task status
• trace_log_event - Log events and activities

Manual Configuration

If you prefer to configure manually, add this to your MCP settings:

{
  "mcpServers": {
    "trace": {
      "command": "npx",
      "args": ["-y", "@ahmed-chouaya/trace", "serve"]
    }
  }
}

Development

# Clone the repository
git clone https://github.com/ahmed-chouaya/trace.git
cd trace

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run locally
node dist/cli/index.js

License

MIT