CLI Reference

Complete reference for all Intentra CLI commands.

Global Options

intentra --help              # Show help
intentra --version           # Show version
intentra -c <path>           # Use custom config file
intentra -d, --debug         # Enable debug output (HTTP requests, local scan saves)
intentra --api-server <url>  # Override API server endpoint
intentra --api-key-id <id>   # Override API key ID
intentra --api-secret <key>  # Override API secret

Debug Mode

Enable debug mode to see HTTP requests and save scans locally:

intentra -d status           # See HTTP request to API
intentra -d scan list        # See HTTP request and save scans locally

When debug mode is enabled:

HTTP requests are logged: [DEBUG] POST https://api.intentra.sh/scans -> 200
Scans are saved locally to ~/.intentra/scans/ regardless of sync status

You can also enable debug mode permanently by adding debug: true to your config file. This is useful for hooks (called by IDEs) where you can't pass the -d flag.

Authentication

Authenticate with your Intentra account using device authorization flow.

intentra login
intentra login --no-browser  # Print URL instead of opening browser

logout

Log out and clear stored credentials.

intentra logout

status

Check current authentication status and display user information.

intentra status

Example output:

Email: [email protected]
Organization: My Organization
Plan: Pro

Tokens are automatically refreshed if expired.

Installation

install

Install hooks for AI tools.

intentra install           # Install for all supported tools
intentra install cursor    # Install for Cursor only
intentra install claude    # Install for Claude Code only
intentra install copilot   # Install for GitHub Copilot only
intentra install antigravity  # Install for Antigravity only (Codeium-based)
intentra install windsurf     # Install for Windsurf only
intentra install gemini       # Install for Gemini CLI only

Supported tools: Cursor, Claude Code, GitHub Copilot, Antigravity, Windsurf, Gemini CLI

uninstall

Remove hooks from AI tools.

intentra uninstall           # Uninstall from all tools
intentra uninstall cursor    # Uninstall from Cursor only
intentra uninstall copilot   # Uninstall from GitHub Copilot only
intentra uninstall antigravity  # Uninstall from Antigravity only
intentra uninstall windsurf     # Uninstall from Windsurf only

hooks status

Check hook installation status.

intentra hooks status

Scans

scan list

List scans from server (if logged in) or local storage.

intentra scan list                  # List recent scans (default: 20)
intentra scan list --summary        # Show summary only, no individual scans
intentra scan list --limit 100      # Return up to 100 scans
intentra scan list --days 7         # Look back 7 days (server mode)
intentra scan list --json           # Output as JSON

scan show

Show details for a specific scan.

intentra scan show <scan-id>

scan today

Show today's scans with summary.

intentra scan today                 # Show today's summary and recent scans
intentra scan today --summary       # Show summary only
intentra scan today --limit 50      # Show up to 50 scans
intentra scan today --json          # Output as JSON

scan aggregate

Process events into scans (local mode).

intentra scan aggregate

Sync

sync now

Force sync all pending scans to the server.

intentra sync now
intentra sync now --keep-local  # Keep local files after syncing

sync status

Show sync status and configuration.

intentra sync status

Configuration

config show

Display current configuration (secrets redacted).

intentra config show

config init

Generate a sample configuration file.

intentra config init > ~/.intentra/config.yaml

config validate

Validate configuration for server sync.

intentra config validate