open-index/open-npm huggingface dataset:
npm package: @moshi-labs/snitch
Description: CLI daemon that reports Claude Code activity to a team server
Author: Moshi Labs
Latest version: 1.0.17

# 🐀 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

```bash
npm install -g @moshi-labs/snitch
```

### Step 2: Configure

```bash
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

```bash
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?"

```bash
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`:

```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