CLI Reference
Complete reference for all Watchdawg CLI commands
Interactive Mode
Running watchdawg with no arguments starts interactive mode. If you're not logged in, it begins the setup flow. Otherwise, it shows a menu with available actions.
watchdawgCommands
watchdawg setup
Configure a project for telemetry collection. This is the recommended way to get started.
watchdawg setupWalks you through project selection, prompt logging preferences, and hook registration. Writes configuration to .watchdawg/config.json and registers Claude Code hooks in the settings file matching your chosen scope.
watchdawg login
Authenticate with your Watchdawg account using a device code flow.
watchdawg loginOpens your browser for verification. Credentials are stored in ~/.watchdawg/credentials.json.
watchdawg logout
Sign out and clear stored credentials.
watchdawg logoutRevokes the session on the server and removes local credentials and project configuration.
watchdawg status
Check your current authentication status.
watchdawg statusShows your email, session expiration, and login state.
Global Flags
| Flag | Alias | Description |
|---|---|---|
--help | -h | Show help |
--version | Show CLI version |
Configuration Files
| File | Location | Purpose |
|---|---|---|
| Credentials | ~/.watchdawg/credentials.json | Auth token and session info |
| Project config | .watchdawg/config.json | Project ID, org ID, collector URL |
| Hooks (local) | .claude/settings.local.json | Per-project hooks, not version controlled |
| Hooks (project) | .claude/settings.json | Per-project hooks, shared via VCS |
| Hooks (global) | ~/.claude/settings.json | Hooks applied to all projects |