CLI command reference
CLI commands for installing, operating, and maintaining Bito's AI Architect.
Complete reference for the bitoarch command-line interface used to manage a self-hosted deployment. Run bitoarch <command> --help for command-specific options.
Status
status
Show the status of all services
health [--verbose]
Check health of all services (per-service detail)
info
Show platform information (version, ports)
diagnose [--verbose]
Diagnostic sweep, pass/warn/fail per section
diagnose --section <name>
One section: prereqs, install, filesystem, config, services, connectivity, cert
diagnose --bundle [--output <dir>]
Redacted .tar.gz for support (→ ~/.bitoarch/diagnostics/)
Lifecycle
start
Start stopped services (idempotent)
stop
Stop all services (keeps data)
restart [--force]
Restart services (--force reloads env and recreates containers)
logs [service]
Tail service logs (-f to follow, all services if omitted)
upgrade [--version=<ver>]
Upgrade the platform, blue/green (latest by default, data preserved)
reset
Remove services, volumes, and configuration (keeps the install directory)
uninstall
Full removal (services + install directory)
Repositories
add-repo <ns> / remove-repo <ns>
Add / remove a repository by namespace
add-repos / update-repos
Apply / update the repository list (edit it with config edit repos)
repo-info <name>
Show repository details
fetch-repo-list [--force-load]
Sync the repository list from the Git provider
Indexing
show-config [--raw]
Show current indexing configuration (--raw = full resolved config)
index-repos [--only-new-repos]
Trigger workspace repository indexing
index-status
Check indexing status (--raw for full payload)
index-repo-list
List all indexed repositories
stop-indexing
Stop indexing completely
create-index-scheduler / update-index-scheduler
Manage scheduled indexing
Configuration
update-api-key
Update the Bito API key
update-git-creds
Update Git provider credentials
update-llm-config
Update custom LLM provider configuration
rotate-mcp-token [<new-token>]
Rotate the MCP access token (auto-generates if omitted)
config path [env|repos|llm]
Print a configuration file path
config edit [env|repos|llm]
Open a configuration file in $EDITOR
MCP
mcp-info
Show MCP configuration (URL, token, auth mode)
mcp-test
Test the MCP connection end-to-end
mcp-tools / mcp-tool-info <name>
List tools / show a tool's details
mcp-capabilities
Show MCP server capabilities
SSO (Enterprise only)
sso setup
Configure SSO (Enterprise IdP or Bito)
sso status
Check SSO configuration and verification
sso enable / sso disable
Re-enable / disable SSO
sso rotate-key
Rotate SSO keys
Insights (optional)
insights config / insights status
Show configuration / workflow status
insights run [--force]
Run analysis (--force re-analyzes all)
insights enable|disable [git|ticket-tracker|docs]
Toggle an insights feature
insights tracker-projects [action] [KEY …]
Manage project keys
insights set-lookback [git|ticket-tracker]
Set lookback days
Standalone-only
mcp-install [--email <addr>]
Register the local MCP with detected AI coding agents
mcp-uninstall
Deregister MCP from AI coding agents
mcp-cert status
Certificate verdict, days remaining, scheduler state
mcp-cert renew [--check]
Re-issue the certificate (--check = only if expiring within 60 days)
mcp-cert schedule [HH:MM]
Show or set the daily auto-renew time
Last updated