Ona - System Command Reference

Complete command reference for Ona command surfaces.

This document covers:

  • ona CLI commands and subcommands
  • per-agent shortcut commands (solin, writer, etc.)
  • Make targets and direct scripts
  • Telegram command entrypoints (summary)

Install CLI shortcuts:

./scripts/install-ona.sh

ona CLI (all top-level commands)

Entry point:

ona <command> [subcommand] [args]

Direct script equivalent:

./scripts/ona <command> [subcommand] [args]
Command Purpose
install Install CLI shortcuts/symlinks
uninstall Remove installed CLI shortcuts
update Pull latest + reinstall CLI
boot Bootstrap entry flow
deps Check/install dependencies
build Build release binaries
build-docker Rebuild Docker images (no cache)
dev-web Run web UI in dev mode
build-web Build web UI bundle
app / electron Launch desktop app
start / up Start services
stop / down Stop services
status Show system status
logs Stream service logs
doctor Run diagnostics
save Create backup archive
clear Clear logs/backups
reset Reset to first-installation state
control Run control server
sphere Sphere integration commands
job Job operations
group Watch mission group chat
thinking Group-style real-time model thinking view
agents List squad agents
agent Send message/create agent
estop Emergency stop
models Model operations and routing assignments
cron Scheduler CRONS helpers
scheduler Scheduler status/list
todos List todos
todo Create/update todo
followups List follow-ups
followup Schedule follow-up
memory Read/write/snapshot/hydrate memory
rag RAG ingest/search
approve List or approve items
reject Reject approval item
providers List LLM providers
channel Channel list/connectivity checks
token Token and token-context management
telegram / telegram-token Telegram token helpers
ollama Ollama helper commands
developer Developer routing/mode controls
config Export config/schema
learning Learning store commands
setup / onboard Interactive setup wizard
setup-init Non-interactive setup
completions Shell completion output
help Show CLI help

Common ona Subcommands

System and lifecycle

  • ona start [-d|--detach] [--no-tunnel] [--models] [--app] [--full] [--no-cache] [--logs=all]
  • ona stop [--no-save]
  • ona status
  • ona logs [service_names...]
  • ona doctor
  • ona save
  • ona clear logs
  • ona clear backups
  • ona reset [--force] [--keep-env] [--prune-docker] [--prune-cargo]

Sphere integration

  • ona sphere setup
  • ona sphere doctor
  • ona sphere start
  • ona sphere stop
  • ona sphere status
  • ona sphere migrate

Jobs and agents

  • ona job create "mission text"
  • ona job create --agent <AgentName> "mission text"
  • ona job list [pending|running|done|failed]
  • ona job <job_id>
  • ona job cancel <job_id>
  • ona job chat <job_id>
  • ona job logs <job_id>
  • ona agents
  • ona agent -m "message to Solin"
  • ona agent create <name> [role]
  • ona group [job_id]
  • ona thinking [job_id]

Emergency stop

  • ona estop
  • ona estop status

Models and routing

  • ona models pull <model>
  • ona models list
  • ona models refresh
  • ona models verify
  • ona models create <name>
  • ona models assignments get
  • ona models assignments set <field> <value>
  • ona models assignments clear <ONA_MODEL_KEY>
  • ona models assignments export [file.json]
  • ona models assignments import <file.json>
  • ona models privacy status
  • ona models privacy local-only
  • ona models privacy hybrid

Todos and follow-ups

  • ona todos [status]
  • ona todo create "title"
  • ona todo update <id> <pending|in_progress|done|cancelled>
  • ona followups
  • ona followup schedule "<due_at>" "<context>" [channel]

Memory and RAG

  • ona memory read [path]
  • ona memory write [path] [content]
  • ona memory snapshot
  • ona memory hydrate
  • ona rag ingest [text]
  • ona rag ingest-path <path>
  • ona rag search "query"

Approvals

  • ona approve list
  • ona approve <approval_id>
  • ona reject <approval_id>

Scheduler and cron

  • ona cron list
  • ona cron add "<cron_expr>" "<job_text>"
  • ona scheduler

Channel/provider/config helpers

  • ona providers
  • ona channel list
  • ona channel check
  • ona config
  • ona config schema

Token and setup helpers

  • ona token list
  • ona token <type> [value]
  • ona token context [max_tokens] [context_limit]
  • ona telegram token [TOKEN]
  • ona telegram-token [TOKEN]
  • ona ollama host
  • ona setup
  • ona onboard
  • ona setup app
  • ona setup-init

Developer and learning commands

  • ona developer mode [auto|fast|deep] [cpu_ollama_url]
  • ona developer cpu-model [model] [cpu_ollama_url]
  • ona developer status
  • ona learning list
  • ona learning store <key> <content>
  • ona learning forget <key>

Shell completions

  • ona completions bash

Per-Agent Shortcut Commands

These are installed by install-ona.sh and route requests directly.

Command Routes to
solin "mission" Solin
solin chat Interactive Solin chat mode
writer "mission" Writer agent
researcher "mission" Researcher agent
developer "mission" Developer agent
marketer "mission" Marketer agent
designer "mission" Designer agent
seo "mission" SEO agent
content-creator "mission" Content Creator agent
sales-agent "mission" Sales Agent
agent "<Name>" "mission" Named agent route

Make Targets

Target Purpose
make boot Bootstrap
make start Start services
make stop Stop services
make status Status check
make build Build binaries
make doctor Diagnostics
make install Install CLI shortcuts
make docker / make docker-up Docker compose up
make docker-down Docker compose down
make bmad-install Install BMad tooling

Direct Scripts

Script Purpose
./scripts/ona Main CLI entrypoint
./scripts/ona-remote Phone/IDE lightweight client
./scripts/solin Solin shortcut
./scripts/agent Generic agent route
./scripts/writer Writer shortcut
./scripts/researcher Researcher shortcut
./scripts/developer Developer shortcut
./scripts/ona-setup.sh Setup wizard script
./scripts/ona-doctor.sh Doctor checks
./scripts/ona-reset.sh Reset helper
./scripts/install-ona.sh CLI installer
./scripts/uninstall-ona.sh CLI uninstaller
./boot/main.sh Boot entry script

Telegram Commands (summary)

For the complete list, use:

Main Solin commands include:

  • /help, /start
  • /ask, /job, /create, /mission, /go
  • /tell, /reminder
  • /notes, /todo
  • /docs, /onadocs
  • /remember, /memory
  • /agents, /calendar, /cron, /assistant, /approvals
  • specialist routes: /research, /write, /code, /design, /search, /landing, /project, /marketing, /seo, /content, /sales

Platform Entry

Platform Command
Linux/macOS ona or ./scripts/ona
Windows cmd ona.cmd
PowerShell pwsh -File scripts/ona.ps1

Related