🐀 Snitch

See what your teammates' Claude Code sessions are working on in real-time.

Dashboard: https://snitch.moshi.ai

Quick Start (5 minutes)

Step 1: Install

npm install -g @moshi-labs/snitch

Step 2: Configure

snitch init

You'll be asked for three things:

| Prompt | What to enter | |--------|---------------| | Server URL | https://snitch.moshi.ai | | API Key | Ask James for the team key | | Your name | Your name (this shows on the dashboard) |

Step 3: Start the daemon

snitch start

That's it! Your Claude Code and Codex activity will now appear on the team dashboard.

Commands

| Command | What it does | |---------|--------------| | snitch start | Start tracking (runs in background) | | snitch stop | Stop tracking | | snitch status | Check if it's running | | snitch logs | View recent logs | | snitch logs -f | Follow logs live |

Troubleshooting

"Is it working?"

snitch status

Should say "Daemon is running". If not, run snitch start.

"I don't see my activity on the dashboard"

1. Make sure you're working in a moshi repo (moshi-api, moshi-frontend, etc.)
2. Check logs for errors: snitch logs
3. Verify your config: cat ~/.snitch/config.json

"I want to reconfigure"

Just run snitch init again. Press Enter to keep existing values.

How It Works

1. Snitch watches ~/.claude/projects/ (Claude Code) and ~/.codex/sessions/ (Codex) session files
2. When you use Claude Code or Codex in a moshi repo, it detects tool calls and messages
3. Activity is sent to the team server
4. Server uses Claude to categorize your work into tickets
5. Dashboard shows what everyone's working on

Codex sessions are marked with a codex label in the UI. Claude sessions remain unlabeled (default behavior).

Config File

Stored at ~/.snitch/config.json:

{
  "serverUrl": "https://snitch.moshi.ai",
  "apiKey": "your-team-key",
  "userName": "Your Name",
  "allowedRepos": ["moshi-api", "moshi-frontend", "moshi-e2e", "terraform", "snitch"]
}

You can edit allowedRepos to track additional repositories.

License

MIT