Available commands
CLI commands for installing, operating, and maintaining Bito's AI Architect.
Quick reference for CLI commands used to install, configure, and manage Bito's AI Architect.
Setup script commands: Use these commands to install AI Architect and manage its initial service setup and lifecycle.
AI Architect management commands (
bitoarch): Use these commands after installation to manage repositories, indexing, configuration, health checks, and MCP operations.
Setup script commands
Commands used to install AI Architect and manage its initial service setup.
./setup.sh
Run interactive setup wizard
./setup.sh --help or -h
Show help message with all available options
./setup.sh --status
Check if services are running
./setup.sh --logs
View service logs for debugging
./setup.sh --stop
Stop all services (preserves containers)
./setup.sh --restart
Restart all services without config changes
./setup.sh --force-restart
Restart all services and reapply environment variables. Use after updating .env-bitoarch file.
./setup.sh --clean
Remove all data and services
AI Architect management commands
Use these bitoarch commands to manage AI Architect.
Core operations
bitoarch index-repos
Trigger workspace repository indexing
Simple index without parameters
bitoarch index-status
Check indexing status
View progress and state
bitoarch index-repo-list
List all repositories
bitoarch index-repo-list --status active
bitoarch show-config
Show current configuration
bitoarch show-config --raw
Examples:
Repository management
bitoarch add-repo <namespace>
Add single repository
bitoarch add-repo myorg/myrepo
bitoarch remove-repo <namespace>
Remove repository
bitoarch remove-repo myorg/myrepo
bitoarch add-repos <file>
Load configuration from YAML
bitoarch add-repos .bitoarch-config.yaml
bitoarch update-repos <file>
Update configuration from YAML
bitoarch update-repos .bitoarch-config.yaml
bitoarch repo-info <name>
Get detailed repository info
bitoarch repo-info myrepo --dependencies
Examples:
Service operations
bitoarch status
View all services status
Docker ps-like output
bitoarch health
Check health of all services
bitoarch health --verbose
bitoarch info
Get platform information
Version, ports, resources
Examples:
Configuration
bitoarch update-api-key
Update Bito API key
Interactive or with --api-key flag
bitoarch update-git-creds
Update Git provider credentials
Interactive or with flags
bitoarch rotate-mcp-token
Rotate MCP access token
bitoarch rotate-mcp-token <new-token>
Examples:
MCP operations
bitoarch mcp-test
Test MCP connection
Verify server connectivity
bitoarch mcp-tools
List available MCP tools
bitoarch mcp-tools --details
bitoarch mcp-capabilities
Show MCP server capabilities
bitoarch mcp-capabilities --output caps.json
bitoarch mcp-resources
List MCP resources
View available data sources
bitoarch mcp-info
Show MCP configuration
Display URL and token info
Examples:
Output options
Add these flags to any command:
--format json
JSON output
For automation/scripts
--raw
Show full API response
For debugging
--output json
Filtered JSON output
For index-status
--help
Show command help
Get usage information
Common workflows
Initial setup
Daily operations
Adding new repositories
Troubleshooting
Getting help
bitoarch --help
Main menu with all commands
bitoarch <command> --help
Command-specific help
Examples:
Environment
Configuration is loaded from .env-bitoarch file. Key variables:
BITO_API_KEY- API key for authenticationGIT_PROVIDER- Git provider (github, gitlab, bitbucket)GIT_ACCESS_TOKEN- Git access tokenBITO_MCP_ACCESS_TOKEN- MCP server access tokenCIS_*_EXTERNAL_PORT- Service external ports
Version
Check CLI version:
Last updated