Skip to content
Instar

CLI Commands

Most users never need these — your agent manages its own infrastructure. These commands are available for power users and for the agent itself to operate.

Setup

Section titled “Setup”
Terminal window
instar                          # Interactive setup wizard
instar setup                    # Same as above
instar init my-agent            # Create a new agent (general or project)

Server

Section titled “Server”
Terminal window
instar server start             # Start the persistent server (background, tmux)
instar server stop              # Stop the server
instar status                   # Show agent infrastructure status

Lifeline

Section titled “Lifeline”
Terminal window
instar lifeline start           # Start lifeline (supervises server, queues messages)
instar lifeline stop            # Stop lifeline and server
instar lifeline status          # Check lifeline health

Auto-Start

Section titled “Auto-Start”
Terminal window
instar autostart install        # Agent starts when you log in
instar autostart uninstall      # Remove auto-start
instar autostart status         # Check if auto-start is installed

Add Capabilities

Section titled “Add Capabilities”
Terminal window
instar add telegram --token BOT_TOKEN --chat-id CHAT_ID
instar add email --credentials-file ./credentials.json [--token-file ./token.json]
instar add quota [--state-file ./quota.json]
instar add sentry --dsn https://key@o0.ingest.sentry.io/0

Users and Jobs

Section titled “Users and Jobs”
Terminal window
instar user add --id alice --name "Alice" [--telegram 123] [--email a@b.com]
instar job add --slug check-email --name "Email Check" --schedule "0 */2 * * *" \
  [--description "..."] [--priority high] [--model sonnet]

Backup and Restore

Section titled “Backup and Restore”
Terminal window
instar backup create            # Snapshot identity, jobs, relationships
instar backup list              # List available snapshots
instar backup restore TIMESTAMP # Restore a snapshot
Section titled “Memory Search”
Terminal window
instar memory search "deployment"  # Full-text search across agent knowledge
instar memory reindex              # Rebuild the search index
instar memory status               # Index stats

Intent Alignment

Section titled “Intent Alignment”
Terminal window
instar intent reflect              # Review recent decisions against stated intent
instar intent org-init             # Scaffold ORG-INTENT.md
instar intent validate             # Check AGENT.md against ORG-INTENT.md
instar intent drift                # Detect behavioral drift over time

Multi-Machine

Section titled “Multi-Machine”
Terminal window
instar machines whoami             # Show this machine's identity
instar machines pair               # Generate a pairing code
instar machines join CODE          # Join using a pairing code

Diagnostics

Section titled “Diagnostics”
Terminal window
instar doctor                      # Run health diagnostics

Feedback

Section titled “Feedback”
Terminal window
instar feedback --type bug --title "Session timeout" --description "Details..."