# Minchenlee C9watch C9watch > c9watch CLI - Skill: `tomevault-io/minchenlee-c9watch-c9watch` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/minchenlee-c9watch-c9watch` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/minchenlee-c9watch-c9watch/raw - Safety review: WARNING (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/minchenlee-c9watch-c9watch --- # c9watch CLI c9watch is a CLI tool that lets you monitor and manage all Claude Code sessions running on the machine. Every command outputs JSON. Use it to see what other sessions are doing, search past work, track costs, and coordinate with sibling agents. ## Before you start Verify `c9watch` is available: ```bash which c9watch && c9watch --version ``` If not installed, tell the user: ``` c9watch CLI is not installed. Install it with: curl -fsSL https://raw.githubusercontent.com/minchenlee/c9watch/main/install-cli.sh | bash ``` ## Commands reference ### List active sessions ```bash c9watch list # all sessions c9watch list --compact # minimal fields (saves tokens) c9watch list --project myapp # filter by project path c9watch list --status NeedsAttention # filter by status ``` Status values: `Working`, `WaitingForInput`, `NeedsAttention`, `Idle` Compact output fields: `id`, `pid`, `status`, `projectPath`, `sessionName`, `pendingToolName` Full output adds: `firstPrompt`, `messageCount`, `modified`, `customTitle`, `gitBranch`, `summary`, `latestMessage`, `pendingToolInput`, `taskProgress` ### Status overview ```bash c9watch status # counts by status and project c9watch status --project myapp # filtered ``` Returns `total`, `byStatus`, `byProject`, and `needsPermission` (sessions waiting for approval). This is the fastest way to answer "is anything stuck?" — check `needsPermission` first. ### Identify yourself ```bash c9watch self ``` Walks the PID tree to find the calling Claude Code process and returns your own session object. Use this to discover your own session ID, project path, git branch, or task progress without the user telling you. ### View a conversation ```bash c9watch view # full conversation c9watch view --last 5 # last 5 messages (saves tokens) ``` Session IDs support prefix matching — `c9watch view abc` resolves to the full UUID if unambiguous. System XML tags are automatically stripped from output. When viewing conversations, prefer `--last N` to avoid loading thousands of tokens from long sessions. Start with `--last 5` and go larger only if needed. ### Browse history ```bash c9watch history # all past sessions c9watch history -n 20 # most recent 20 ``` Returns: `sessionId`, `firstPrompt`, `display`, `date` (ISO 8601), `project`, `projectName`, `customTitle`. ### Search past sessions ```bash c9watch search "implement auth middleware" c9watch search "fix bug" --project myapp -n 10 ``` Multi-word queries use AND logic — all words must appear somewhere in the session. Returns `hits[]` with `sessionId`, `snippet`, `projectPath`, `modified`. ### View tasks ```bash c9watch tasks ``` Returns `total`, `completed`, `inProgress`, `pending`, and the full `tasks[]` array. ### Stop a session ```bash c9watch stop ``` Takes the PID (not session ID). Get the PID from `c9watch list`. Always confirm with the user before stopping a session — this is destructive and irreversible. ### Watch for changes ```bash c9watch watch # stream all events c9watch watch --changes-only --compact # only changes, minimal fields c9watch watch --project myapp --interval 5 # filtered, slower poll ``` Streams NDJSON (one JSON object per line). Events: `started`, `status_changed`, `stopped`. This is a long-running command — run it in the background if you need to monitor while doing other work. ## Choosing the right command | User wants to know... | Command | |----------------------|---------| | "What's running right now?" | `c9watch list --compact` | | "Is anything stuck/waiting?" | `c9watch status` then check `needsPermission` | | "What's session X doing?" | `c9watch view --last 3` | | "What did I work on recently?" | `c9watch history -n 20` | | "Find that conversation where..." | `c9watch search ""` | | "How far along is that task?" | `c9watch tasks ` | | "Who am I?" | `c9watch self` | | "Stop that other session" | `c9watch list` to find PID, confirm, then `c9watch stop ` | ## Tips for effective use - Always use `--compact` on `list` when you only need status info. Full output includes conversation content which wastes tokens. - Use `--last N` on `view` to avoid loading entire long conversations. - Pipe through `jq` for filtering: `c9watch list | jq '.sessions[] | select(.status == "NeedsAttention")'` - The `self` command only works when called from within a Claude Code session (it needs a claude parent process in the PID tree). - `--pretty` on any command gives indented JSON for human-readable output, but costs more tokens. Skip it when parsing programmatically. --- > Source: [minchenlee/c9watch](https://github.com/minchenlee/c9watch) — distributed by [TomeVault](https://tomevault.io).