Skip to content

sebasnallar/caw

 
 

Repository files navigation

caw — coding assistant watcher

caw

coding assistant watcher

Watch every coding agent from one quiet perch.

CI License: MIT

caw watches the coding assistants running on your machine and turns them into one calm operational view. Scan status, group sessions, and jump back to the right terminal without digging around.

Supported Assistants

Assistant Status
Claude Code Supported
OpenAI Codex CLI Stub (process detection)
OpenCode Stub (process detection)

Install

brew install pablovilas/tap/caw

Or build from source:

cargo install --git https://github.com/pablovilas/caw.git

Usage

caw              Auto-detect (terminal → dashboard, background → tray)
caw watch        Live interactive dashboard
caw tray         Menu bar app with session overview
caw status       One-line status for shell prompts (e.g. 2w 1a 0i)
caw serve        Run as a background daemon
caw debug        Print raw process discovery info

Status

Symbol Status Meaning
working Session is actively generating
waiting Waiting for user input
idle Present but inactive
dead Process ended or disconnected

Architecture

caw/
├── crates/
│   ├── caw-core/              # Plugin trait, types, monitor engine
│   ├── caw-plugin-claude/     # Claude Code plugin
│   ├── caw-plugin-codex/      # Codex CLI plugin
│   ├── caw-plugin-opencode/   # OpenCode plugin
│   └── caw/                   # Binary: tray, dashboard, CLI
└── docs/                      # Assets and documentation

Development

just setup    # Configure git hooks
just ci       # Run lint + tests
just build    # Build release binary
just run      # Run in dev mode

Contributing

See CONTRIBUTING.md.

License

MIT

About

Monitor your AI coding assistants. Track Claude Code, Codex, and OpenCode sessions from the menu bar, terminal, or shell prompt — see status, tokens, and last messages at a glance.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Rust 97.4%
  • Just 2.5%
  • Shell 0.1%