Skip to main content

​
CLI Reference

The smoltbot CLI configures your local environment for transparent AI agent tracing and provides commands to query your agent’s transparency data.

​
Installation

npm install -g smoltbot

​
Commands

1
smoltbot init
2
Configure tracing for your AI agent. This command detects your configured AI provider API keys (Anthropic, OpenAI, Gemini) and configures your local environment to route API calls through the Mnemom gateway.
3
smoltbot init
4
What it does:
5
  • Detects configured AI provider API keys in your environment
  • Configures your local environment to route API calls through the Mnemom gateway
  • Registers your agent automatically using a SHA-256 hash of your API key (the key itself never leaves your machine)
  • Supports multi-provider setups (Anthropic, OpenAI, Gemini)
    • 6
    Options:
    7
    OptionDescription--gateway=<url>Use a custom gateway URL (for self-hosted deployments)
    8
    Example:
    9
    # Default setup — uses Mnemom hosted gateway
smoltbot init

# Self-hosted gateway
smoltbot init --gateway=https://your-domain.com
    10
    smoltbot status
    11
    Show agent status, connected providers, and connection info.
    12
    smoltbot status
    13
    Output includes:
    14
  • Agent ID
  • Connected providers (Anthropic, OpenAI, Gemini)
  • Gateway URL
  • Connection status
  • Last activity timestamp
    • 15
    Example output:
    16
    Agent:    agent_abc123def456
Gateway:  https://gateway.mnemom.ai
Status:   Connected
Providers:
  Anthropic  ✓ (Claude Opus 4.6)
  OpenAI     ✓ (GPT-5.2)
  Gemini     ✗ (not configured)
Last seen: 2 minutes ago
    17
    smoltbot integrity
    18
    Display integrity score and verification statistics for your agent.
    19
    smoltbot integrity
    20
    Output includes:
    21
  • Overall integrity ratio (percentage of clear verdicts)
  • Verification statistics (total traces, violations, warnings)
  • Drift alert status
  • Recent concern categories
    • 22
    Example output:
    23
    Integrity Score: 0.94 (94%)
Traces verified: 1,247
Violations:      12 (3 CRITICAL, 9 HIGH)
Drift alerts:    0 active
Window:          10 checkpoints, 2h retention
    24
    smoltbot logs
    25
    Show recent traces and actions.
    26
    smoltbot logs [-l N]
    27
    Options:
    28
    OptionDescriptionDefault-l NNumber of log entries to display10
    29
    Example:
    30
    # Show last 10 traces (default)
smoltbot logs

# Show last 50 traces
smoltbot logs -l 50
    31
    Example output:
    32
    2026-02-17 14:32:01  CLEAR      api_call    Claude Opus 4.6    "Search for documents"
2026-02-17 14:31:45  CLEAR      api_call    Claude Opus 4.6    "Summarize results"
2026-02-17 14:31:12  REVIEW     api_call    GPT-5.2            "Execute trade"
  └─ concern: autonomy_violation (HIGH) — action exceeds bounded_actions
2026-02-17 14:30:58  CLEAR      api_call    Claude Opus 4.6    "Draft email"

    ​
    Workflow

    A typical workflow with the smoltbot CLI:
    1
    Set up tracing
    2
    smoltbot init
    3
    Verify your agent is connected
    4
    smoltbot status
    5
    Use your AI agent normally
    6
    Your API calls are automatically traced through the gateway. No code changes required.
    7
    Check integrity
    8
    smoltbot integrity
    9
    Review recent activity
    10
    smoltbot logs -l 20
    11
    Claim your agent (optional)
    12
    Link your agent to your Mnemom account for a private dashboard:
    13
  • Run smoltbot status to get your agent ID
  • Go to mnemom.ai/claim
  • Paste your agent ID and prove ownership

    • ​
    Supported Providers

    The CLI automatically detects and configures tracing for these providers:
    ProviderModelsThinking/AIPAuth Method
    AnthropicClaude Opus 4.6, Opus 4.5, Sonnet 4.5Full (thinking blocks)x-api-key
    OpenAIGPT-5.2, GPT-5.2 Pro, GPT-5Via reasoning summariesAuthorization: Bearer
    GeminiGemini 2.5 Pro, Gemini 3 ProFull (thought parts)x-goog-api-key