Codeusage CLI

Track your team's AI coding tool usage with zero friction. Get visibility into how AI coding tools like Claude Code and Codex are used across your organization.

Requirements

• Node.js 18+
• Claude Code or Codex CLI installed

Installation

bun add -g codeusage-cli

Or with npm:

npm install -g codeusage-cli

Quick Start

1. Sign up at codeusage.dev to get your workspace API key

2. Initialize the CLI:

codeusage init

3. Done! Usage is now tracked automatically when you use an AI coding tool.

Commands

codeusage init

Interactive setup wizard. Configures your API key, developer alias, and installs hooks.

codeusage init

codeusage status

Check your current configuration and connection status.

codeusage status

codeusage project

Manage project mappings for the current directory.

# Set a custom project name for current directory
codeusage project set my-project

# List all project mappings
codeusage project list

# Ignore current directory (no tracking)
codeusage project ignore

# Re-enable tracking for current directory
codeusage project unignore

codeusage provider

Manage AI coding tool providers.

# List all available providers
codeusage provider list

# Show current provider
codeusage provider current

# Add hooks for an additional provider (keeps existing)
codeusage provider add <provider>

# Switch to a different provider
codeusage provider switch <provider>

codeusage guard

Manage Prompt Guard — scans prompts for credentials before sending. Also available as codeusage patterns.

# Enable Prompt Guard
codeusage guard enable

# Disable Prompt Guard
codeusage guard disable

# Show status and cache info
codeusage guard status

# List all active patterns
codeusage guard list

# Sync patterns from workspace settings
codeusage guard sync

# Test a string against patterns
codeusage guard test "my-secret-key-123"

codeusage sync

Manually sync the last task (useful for testing).

codeusage sync

codeusage config

View or update configuration values.

# View all config
codeusage config

# View specific value
codeusage config get developer_alias

# Set a value
codeusage config set developer_alias "john"

codeusage logs

View CLI error and diagnostic logs.

# Show recent errors (default: last 50 lines)
codeusage logs

# Show more lines
codeusage logs -n 100

# Filter by level
codeusage logs --level warn

# Show all log levels
codeusage logs --all

# Print log file path
codeusage logs --path

# Clear all logs
codeusage logs --clear

codeusage logout

Remove all local configuration and uninstall hooks.

codeusage logout

Uninstall

bun remove -g codeusage-cli

Or with npm:

npm uninstall -g codeusage-cli

Documentation

For full documentation, visit codeusage.dev/docs

License

MIT