Skip to main content
The ai-status command displays your current AI Runner configuration, authentication status, available providers, and model settings.

Syntax

What It Shows

Authentication Status

For each configured provider:
  • Authentication method (API key, credentials file, subscription)
  • Status (✓ configured or ✗ not configured)
  • Key presence (shows whether API keys/credentials are set)

Model Configuration

  • Default model IDs for each tier (Opus, Sonnet, Haiku)
  • Small/fast model used for background operations
  • Custom model overrides in ~/.ai-runner/secrets.sh

Current Session

If run inside an active ai session:
  • Active provider and model
  • Authentication method in use
  • Session ID

Example Output

Use Cases

Verify Provider Setup

After configuring credentials in ~/.ai-runner/secrets.sh, run ai-status to verify:

Debug Connection Issues

When a provider isn’t working:

Check Active Session

From within an ai session, run /status in Claude or ai-status in another terminal to see which provider and model are active.

View Model Defaults

See what model each tier flag resolves to:

Configuration Files

The command reads from:
  • ~/.ai-runner/secrets.sh - API keys and credentials
  • ~/.ai-runner/models.sh - Model ID configuration
  • ~/.ai-runner/defaults.sh - Saved defaults from --set-default
  • ~/.claude/settings.json - Claude subscription status

Provider Status Indicators

Troubleshooting

Add the required credentials to ~/.ai-runner/secrets.sh:
Uncomment and fill in the appropriate section for your provider.
For Ollama:
For LM Studio:
Check for overrides in ~/.ai-runner/secrets.sh:
Remove or update model overrides as needed.

ai

Run AI prompts with provider switching

ai-sessions

List active AI sessions