CLI Reference
Complete reference for all neun CLI commands
Interactive Mode
Running neun-cli 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.
neun-cliCommands
neun-cli setup
Configure a project for telemetry collection. This is the recommended way to get started.
neun-cli setupWalks you through project selection, prompt logging preferences, and hook registration. Writes configuration to .neun/config.json and registers Claude Code hooks in the settings file matching your chosen scope.
neun-cli login
Authenticate with your neun account using a device code flow.
neun-cli loginOpens your browser for verification. Credentials are stored in ~/.neun/credentials.json.
neun-cli logout
Sign out and clear stored credentials.
neun-cli logoutRevokes the session on the server and removes local credentials and project configuration.
neun-cli status
Check your current authentication status.
neun-cli 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 | ~/.neun/credentials.json | Auth token and session info |
| Project config | .neun/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 |