# `adk` command reference Every top-level command, generated from the parser itself — so this cannot describe a command that does not exist, and cannot omit one that does. Run `adk --help` for the authoritative, always-current detail. **123 commands.** | command | what it does | |---|---| | [`adk acp`](#adk-acp) | Agent Client Protocol: serve an agent to ACP editors, or drive an external ACP agent | | [`adk addon`](#adk-addon) | Manage self-hosted addons / components (Qdrant, RAG, awgym, awdesk, ...) | | [`adk admin`](#adk-admin) | Administration commands | | [`adk aeon`](#adk-aeon) | Multi-agent group chat | | [`adk agent`](#adk-agent) | Run/manage host-tier agent loops (run, list, status, stop) | | [`adk agent-prompt`](#adk-agent-prompt) | Print the setup prompt for AI coding agents | | [`adk agents`](#adk-agents) | Discover agents in the mesh (ls) | | [`adk ambient`](#adk-ambient) | Make the agent an expert on what you're doing in this terminal | | [`adk approvals`](#adk-approvals) | List/approve/deny A2A permission cards blocking federated agents | | [`adk awconnect`](#adk-awconnect) | Install / check the Awconnect browser extension | | [`adk backend`](#adk-backend) | Manage LLM backends (list, set, test, switch, status) | | [`adk backup`](#adk-backup) | Backup all agent data (memory, graphs, config) | | [`adk balance`](#adk-balance) | Show your Aitherium credit balance and earnings | | [`adk bonsai-local`](#adk-bonsai-local) | Run Bonsai 2 27B on your own hardware (:8090) — GPU or CPU; aitherium.com then chats locally | | [`adk bricks`](#adk-bricks) | Aither World bricks and the awnix OS — list, outdated, upgrade (tested, auto-rollback), rollback | | [`adk briefs`](#adk-briefs) | List and read executive briefs | | [`adk chat`](#adk-chat) | Chat with a mesh agent by name (adk chat [msg]) | | [`adk claude`](#adk-claude) | Run scoped headless Claude Code subagents (serve/spawn/runs/kill) | | [`adk claude-account`](#adk-claude-account) | Manage multiple Claude Code (Anthropic) account profiles | | [`adk claude-model`](#adk-claude-model) | Switch Claude Code between DeepSeek, Kimi, local AitherOS models, and Anthropic | | [`adk component`](#adk-component) | | | [`adk components`](#adk-components) | | | [`adk connect`](#adk-connect) | Connect to AitherOS — detect LLMs, set up gateway, or join desktop mesh | | [`adk contribute`](#adk-contribute) | Teach Aither's ARC world model — enroll, then play & stream transitions (free) | | [`adk costs`](#adk-costs) | Show cloud inference costs, savings, and budget | | [`adk create-app`](#adk-create-app) | Scaffold a awkit workspace app | | [`adk cron`](#adk-cron) | Manage scheduled tasks | | [`adk decide`](#adk-decide) | Decision cards — raise a structured ask, list what is waiting, answer it | | [`adk deploy`](#adk-deploy) | Deploy AitherOS components or agents | | [`adk desk`](#adk-desk) | Interact with awdesk bridge: send commands, view history | | [`adk devices`](#adk-devices) | List, inspect and remove the devices enrolled in your workspace | | [`adk disconnect`](#adk-disconnect) | Disconnect from desktop AitherOS mesh | | [`adk doc`](#adk-doc) | Manage encrypted documents (upload, list, download, delete) | | [`adk doctor`](#adk-doctor) | Check system health (Python, GPU, LLM backends, API keys) | | [`adk down`](#adk-down) | Stop the agent + tunnel and remove its autostart | | [`adk embed`](#adk-embed) | Embed text with the tenant platform's embedding engine | | [`adk enroll`](#adk-enroll) | Register this workstation with the control plane | | [`adk eval`](#adk-eval) | Evaluate MCP tools and packs on a connected gateway | | [`adk explore`](#adk-explore) | Browse packs, agents, and skills in the Aitherium marketplace | | [`adk fleet`](#adk-fleet) | Create & manage a fleet of agents (local \| managed \| hosted \| cloud-run) | | [`adk fleet-host`](#adk-fleet-host) | awnix fleet host (WSL2): status, start/stop/restart, reattach data, migrate (dry-run default) | | [`adk forge`](#adk-forge) | Dispatch tasks to agent forge (Genesis) | | [`adk gateway`](#adk-gateway) | Run agent across messaging platforms | | [`adk gobbonet`](#adk-gobbonet) | Run GobboNet with keyless web search (clones the UI if needed) | | [`adk gpu`](#adk-gpu) | the 5090: status \| sleep (game on) \| wake (game off) -- fleet_verbs.py, dry-run default | | [`adk graph`](#adk-graph) | Provenance graph management (status, drain, claim, ground, context, leaves, lineage, runs, show, purge) | | [`adk grid`](#adk-grid) | Manage grid distributed nodes (add, remove, list, test, sync) | | [`adk harness`](#adk-harness) | AitherShell — drive Claude Code, other coding harnesses, agents and real terminals | | [`adk home`](#adk-home) | Agent Home: host your own agent, pick its model and harness, and let it join games | | [`adk host`](#adk-host) | Host a self-hosted agent (your model key) + connect it to your fleet — one command | | [`adk image`](#adk-image) | Generate an image on a local backend (ComfyUI/Sana/SD.Next) | | [`adk index`](#adk-index) | Index a codebase for code search (CodeGraph) | | [`adk ingest`](#adk-ingest) | Ingest files into the agent's knowledge graph | | [`adk init`](#adk-init) | Scaffold a new agent project | | [`adk install`](#adk-install) | Install an agent pack (e.g. adk install pack:openclaw) | | [`adk instance`](#adk-instance) | Create & manage Aitherium Instances (always-on agent with a stable URL) | | [`adk integrate`](#adk-integrate) | Connect external tools (OpenClaw, etc.) | | [`adk invoke`](#adk-invoke) | Invoke a tool on a mesh agent over signed A2A (adk invoke ) | | [`adk jobs`](#adk-jobs) | Manage background jobs — LOCAL by default, --remote for the portal/cloud | | [`adk join`](#adk-join) | One-command community node onboarding (GitHub auth + hardware detection + serve + mesh join + earnings) | | [`adk kb`](#adk-kb) | Tenant knowledge base on the platform: ingest, query | | [`adk keys`](#adk-keys) | Manage cloud provider API keys (set, list, test, remove) | | [`adk license`](#adk-license) | Show or sync your license (purchases follow your Aitherium account) | | [`adk link`](#adk-link) | link this machine to aitherium.com (one sign-in, role-aware bundle) | | [`adk listen`](#adk-listen) | Real-time audio intelligence — audiobook, meeting, voice notes | | [`adk login`](#adk-login) | Authenticate with Aitherium (browser device flow) | | [`adk logout`](#adk-logout) | Clear saved auth tokens | | [`adk lookout`](#adk-lookout) | Watch Slack, Linear triage or event streams; step in when help is wanted | | [`adk mail`](#adk-mail) | Sovereign mail: one-command Proton Bridge setup | | [`adk mcp`](#adk-mcp) | MCP server, IDE setup, and cloud gateway connection | | [`adk memory`](#adk-memory) | Tenant memory on the platform: remember, recall | | [`adk mesh`](#adk-mesh) | AitherMesh overlay operations (onboard, list peers) | | [`adk mobile`](#adk-mobile) | Test Android/iOS apps end to end (Maestro) and keep screenshots as proof | | [`adk new`](#adk-new) | Scaffold a full template app (e.g. deep-research) | | [`adk notebook`](#adk-notebook) | Plan, run, and inspect Agent Notebooks (.anb) on Genesis | | [`adk onboard`](#adk-onboard) | Interactive onboarding — detect, configure, integrate | | [`adk pack`](#adk-pack) | Manage ToolPack extensions (list, search, install, remove, info) | | [`adk packs`](#adk-packs) | List available agent packs | | [`adk pair`](#adk-pair) | Pair this machine with the portal as an inference node (6-char code from the portal) | | [`adk patterns`](#adk-patterns) | Prompt patterns: list, show, run, import | | [`adk platform`](#adk-platform) | Internal platform toolkit (merged from aither-platform) | | [`adk publish`](#adk-publish) | Publish agent to the Aitherium marketplace | | [`adk publish-preflight`](#adk-publish-preflight) | Check a package can actually be published: an interpreter that meets requires-python, and a wheel that installs AND imports | | [`adk quickstart`](#adk-quickstart) | Sign in, enrol this device and show it in your fleet (--cloud: BYOK provider keys) | | [`adk quickstart-local`](#adk-quickstart-local) | Local inference quickstart (no cloud required) | | [`adk rc`](#adk-rc) | Remote control: enrol this machine and hold the link so its sessions are reachable from your phone | | [`adk register`](#adk-register) | Create a new Aitherium account | | [`adk relay`](#adk-relay) | Connect this agent to AitherRelay chat (join + serve DMs) | | [`adk reregister`](#adk-reregister) | Re-register endpoint(s) with A2A public keys (backfill for existing endpoints) | | [`adk routing`](#adk-routing) | Manage per-intent model routing (which model handles which task) | | [`adk run`](#adk-run) | Start the agent server | | [`adk sandbox`](#adk-sandbox) | Self-host AitherSandbox + link it to your portal (optional safe-testing) | | [`adk secret`](#adk-secret) | Manage secrets (list, get, set, pull, push, sync) | | [`adk setup`](#adk-setup) | Interactive GPU setup wizard (vLLM/Ollama) + optional AitherOS stack | | [`adk setup-all`](#adk-setup-all) | Install/set up all AitherOS client products (adk + shell + node + connect) | | [`adk shell`](#adk-shell) | Launch AitherShell interactive terminal | | [`adk skills`](#adk-skills) | Manage learned skills | | [`adk solve`](#adk-solve) | Run the reasoning loop on an environment (toy or ARC-AGI-3) with a model backend | | [`adk soul`](#adk-soul) | Import/export SOUL.md identity files | | [`adk spec`](#adk-spec) | Spec-driven change workflow: proposal -> delta specs -> tasks -> archive | | [`adk ssh`](#adk-ssh) | Open a remote terminal into a prod/dev environment via the tunnel | | [`adk ssh-cert`](#adk-ssh-cert) | Fetch a short-lived SSH certificate from the AitherCert SSH CA (GitHub org SSH) | | [`adk stack`](#adk-stack) | Start the consumer stack (Room + Ollama) as native processes | | [`adk start`](#adk-start) | Start chatting with your codebase (zero config) | | [`adk status`](#adk-status) | Show backend and service status | | [`adk storage`](#adk-storage) | Storage inventory — scan a drive, rank what fills it, diff, propose, apply | | [`adk support`](#adk-support) | Get help — Discord, GitHub, docs | | [`adk sync`](#adk-sync) | Sync local directory with AitherOS platform | | [`adk test`](#adk-test) | Run agent tests | | [`adk tools`](#adk-tools) | Manage available tools (list, sync from platform) | | [`adk train`](#adk-train) | Manage model training (launch, monitor, cancel) | | [`adk ui`](#adk-ui) | Manage the agent's web UI pack (ls / set / path) | | [`adk up`](#adk-up) | Run a persistent agent connected to your AitherOS fleet (one command) | | [`adk upgrade`](#adk-upgrade) | Open upgrade/checkout page for a pack or plan | | [`adk vault`](#adk-vault) | Lockbox for the live secrets vault (setup, ls, get, search, rotate, lock) | | [`adk voice`](#adk-voice) | Voice services (serve standalone HTTP server) | | [`adk volunteer`](#adk-volunteer) | Volunteer embedding compute for DGG (enroll, serve, start) | | [`adk whoami`](#adk-whoami) | Show current auth status, config and entitlement tier | | [`adk wizard`](#adk-wizard) | First-run wizard — hardware detection, setup recommendations, auth token | | [`adk wm`](#adk-wm) | World model management (status, inspect, train, reset) | | [`adk workflow`](#adk-workflow) | Claude Code Workflow runs mirrored as expeditions | | [`adk workspace`](#adk-workspace) | Manage dev workspaces on AitherOS tunnel | | [`adk x-session`](#adk-x-session) | Bootstrap the autonomous X poster's logged-in session | --- ## `adk acp` Agent Client Protocol: serve an agent to ACP editors, or drive an external ACP agent **Subcommands** - `adk acp serve` — Serve an AitherOS agent over ACP stdio (the editor-facing entrypoint) - `adk acp login` — Interactive AitherIdentity sign-in (ACP Terminal Auth entrypoint) - `adk acp connect` — Connect to an external ACP agent and report its identity - `adk acp prompt` — Prompt an external ACP agent once and print its reply - `adk acp list-sessions` — List sessions of an external ACP agent - `adk acp config` — Emit editor config that runs `adk acp serve` as an ACP agent ## `adk addon` Manage self-hosted addons / components (Qdrant, RAG, awgym, awdesk, ...) **Subcommands** - `adk addon list` — Show available addons + status - `adk addon enable` — Pull image, start container, register with portal - `adk addon disable` — Stop container, deregister - `adk addon status` — Health + metrics for addons - `adk addon logs` — Tail container logs - `adk addon update` — Pull latest images for all enabled addons ## `adk admin` Administration commands **Subcommands** - `adk admin create-token` — Create a node token on the desktop for mesh enrollment ## `adk aeon` Multi-agent group chat | option | type | required | default | description | |---|---|---|---|---| | `-p`, `--preset` | str | | | Preset: balanced, creative, technical, security, minimal, duo_code, research | | `-a`, `--agents` | str | | | Comma-separated agent names (e.g. demiurge,athena) | | `-r`, `--rounds` | int | | `1` | Discussion rounds per message (default: 1) | | `--no-synthesize` | str | | `false` | Skip orchestrator synthesis | ## `adk agent` Run/manage host-tier agent loops (run, list, status, stop) **Subcommands** - `adk agent run` — Start a host-tier agent loop - `adk agent list` — List running agent loops - `adk agent status` — Show status of an agent loop - `adk agent stop` — Stop a running agent loop - `adk agent bind` — Apply a pack (listing or license) to your agent binding - `adk agent swap-brain` — Swap the agent's brain pack - `adk agent backend` — Set the agent's backend (local \| managed \| ...) - `adk agent managed` — Managed (hosted twin) agent: status\|chat\|run\|resync\|byok ## `adk agent-prompt` Print the setup prompt for AI coding agents | option | type | required | default | description | |---|---|---|---|---| | `--raw` | str | | `false` | Print raw prompt without footer | ## `adk agents` Discover agents in the mesh (ls) **Subcommands** - `adk agents ls` — List every agent in the mesh + its inference backend ## `adk ambient` Make the agent an expert on what you're doing in this terminal **Subcommands** - `adk ambient install` — Add the shell hook to your profile (opt-in) - `adk ambient uninstall` — Remove the shell hook - `adk ambient report` — Report one finished command (called by the shell hook) - `adk ambient brief` — What does the agent already know about this? - `adk ambient status` — Show ambient loop stats and engine health ## `adk approvals` List/approve/deny A2A permission cards blocking federated agents **Subcommands** - `adk approvals list` — Show pending permission cards - `adk approvals approve` — Approve a card and mint its one-time grant token - `adk approvals deny` — Refuse a card; no token is minted | option | type | required | default | description | |---|---|---|---|---| | `--url` | str | | | A2A gateway base URL (default $AITHER_A2A_URL or https://127.0.0.1:8766) | | `--json` | str | | `false` | Emit raw JSON | ## `adk awconnect` Install / check the Awconnect browser extension **Subcommands** - `adk awconnect install` — Stage the extension, open the browser's extensions page, copy the folder path, and watch for the load - `adk awconnect status` — Is Awconnect loaded, enabled and current in any browser? - `adk awconnect path` — Print the folder to Load unpacked ## `adk backend` Manage LLM backends (list, set, test, switch, status) **Subcommands** - `adk backend list` — Show detected and configured backends - `adk backend guide` — Step-by-step setup guide for a backend (no arg = menu) - `adk backend set` — Set default backend - `adk backend add` — Register a custom backend (acp: drive an external ACP agent) - `adk backend set-reasoning` — Set reasoning-only backend (effort 7+) - `adk backend test` — Test current backend with a simple prompt - `adk backend switch` — Switch to a different inference backend - `adk backend use` — Switch the RUNNING agent live to a preset (no restart) - `adk backend status` — Show current backend configuration and connectivity ## `adk backup` Backup all agent data (memory, graphs, config) | option | type | required | default | description | |---|---|---|---|---| | `-o`, `--output` | str | | | Output file path (default: aither-backup-.tar.gz) | ## `adk balance` Show your Aitherium credit balance and earnings ## `adk bonsai-local` Run Bonsai 2 27B on your own hardware (:8090) — GPU or CPU; aitherium.com then chats locally | option | type | required | default | description | |---|---|---|---|---| | `--port` | int | | `8090` | Host port to serve on (default: 8090) | | `--model` | str | | `bonsai2-27b` | bonsai2-27b (default; PQ2_0/PTQ1_0, needs the PrismML fork >= prism-b10685) or bonsai-27b (the previous generation) | | `--dry-run` | str | | `false` | Show what would run without starting anything | | `--stop` | str | | `false` | Stop and remove the local Bonsai container | ## `adk bricks` Aither World bricks and the awnix OS — list, outdated, upgrade (tested, auto-rollback), rollback | option | type | required | default | description | |---|---|---|---|---| | `` | str | | | list \| outdated \| upgrade \| test \| rollback \| os \| history | ## `adk briefs` List and read executive briefs **Subcommands** - `adk briefs list` — List recorded briefs - `adk briefs show` — Print one brief in full ## `adk chat` Chat with a mesh agent by name (adk chat [msg]) | option | type | required | default | description | |---|---|---|---|---| | `` | str | yes | | Agent name from `adk agents ls` | | `` | str | | | Message (omit for an interactive loop) | ## `adk claude` Run scoped headless Claude Code subagents (serve/spawn/runs/kill) **Subcommands** - `adk claude serve` — Run the subagent runner daemon - `adk claude spawn` — Spawn a scoped subagent run - `adk claude runs` — List subagent runs - `adk claude kill` — Cancel a run - `adk claude setup` — Install the awsh plugin + apply the awsettings preset - `adk claude doctor` — Audit Claude Code settings/hooks/MCP (CCD001-006) ## `adk claude-account` Manage multiple Claude Code (Anthropic) account profiles **Subcommands** - `adk claude-account save` — Save current Claude Code login - `adk claude-account list` — List saved profiles - `adk claude-account switch` — Switch to a saved profile - `adk claude-account current` — Show current profile name - `adk claude-account remove` — Delete a saved profile - `adk claude-account usage` — Show multi-account usage and scheduling status ## `adk claude-model` Switch Claude Code between DeepSeek, Kimi, local AitherOS models, and Anthropic **Subcommands** - `adk claude-model list` — Show available model profiles - `adk claude-model use` — Switch Claude Code to a profile - `adk claude-model status` — Show the active profile - `adk claude-model check` — Prove the active profile answers a real turn - `adk claude-model bridge` — Manage the translation bridge - `adk claude-model auto` — One-shot: start bridge + switch + verify - `adk claude-model failover` — Test current; if broken, switch to next working provider - `adk claude-model watch` — NOT IMPLEMENTED — use `adk claude-model failover` - `adk claude-model plan` — → Anthropic Opus 5 (architecture, design, review) - `adk claude-model code` — → DeepSeek Flash (fast ultracode, 1M context) - `adk claude-model reason` — → DeepSeek Pro (deep reasoning, 1M context) - `adk claude-model kimi` — → Kimi K3 (1M context, thinking always on) - `adk claude-model local` — → qwen3.6-27b on DGX - `adk claude-model fast` — → gemma4-12b for trivial tasks ## `adk component` **Subcommands** - `adk component list` — Show available addons + status - `adk component enable` — Pull image, start container, register with portal - `adk component disable` — Stop container, deregister - `adk component status` — Health + metrics for addons - `adk component logs` — Tail container logs - `adk component update` — Pull latest images for all enabled addons ## `adk components` **Subcommands** - `adk components list` — Show available addons + status - `adk components enable` — Pull image, start container, register with portal - `adk components disable` — Stop container, deregister - `adk components status` — Health + metrics for addons - `adk components logs` — Tail container logs - `adk components update` — Pull latest images for all enabled addons ## `adk connect` Connect to AitherOS — detect LLMs, set up gateway, or join desktop mesh | option | type | required | default | description | |---|---|---|---|---| | `--api-key` | str | | | AITHER_API_KEY for cloud inference | | `--elysium` | str | | | Connect to desktop AitherOS (e.g. http://192.168.1.10:8001) | | `--token` | str | | | Node token for desktop mesh authentication | | `--save` | str | | `true` | Save config to ~/.aither/config.json (default: true) | | `--no-save` | str | | `true` | Don't save config | ## `adk contribute` Teach Aither's ARC world model — enroll, then play & stream transitions (free) **Subcommands** - `adk contribute register` — Mint a free wallet + contributor token (idempotent) - `adk contribute play` — Play ARC games and stream every transition (needs: pip install 'awdk[arc]') - `adk contribute status` — Your accepted count + daily quota - `adk contribute leaderboard` — Who has taught it the most - `adk contribute solo` — Print the one-command self-host (train YOUR own model) ## `adk costs` Show cloud inference costs, savings, and budget **Subcommands** - `adk costs summary` — Show cost summary (default) - `adk costs compare` — Compare AitherOS vs raw API costs - `adk costs budget` — Set monthly spending budget | option | type | required | default | description | |---|---|---|---|---| | `--period` | str | | `day` | Time period | ## `adk create-app` Scaffold a awkit workspace app | option | type | required | default | description | |---|---|---|---|---| | `` | str | yes | | App name (e.g. 'ACME Assistant') | | `-o`, `--output` | str | | | Output directory (default: ./) | | `--company` | str | | | Company name | | `--industry` | str | | `general` | Industry vertical | | `--description` | str | | | What this app does | | `--subdomain` | str | | | URL slug (auto-derived from name) | | `--color` | str | | `#6366f1` | Primary brand color | | `--template` | str | | `default` | Base template (default: default) | | `--llm-provider` | str | | `aitheros` | LLM provider (default: aitheros) | | `--force` | str | | `false` | Overwrite existing directory | ## `adk cron` Manage scheduled tasks **Subcommands** - `adk cron list` — List scheduled jobs - `adk cron add` — Add a cron job - `adk cron remove` — Remove a cron job ## `adk decide` Decision cards — raise a structured ask, list what is waiting, answer it | option | type | required | default | description | |---|---|---|---|---| | `` | str | | | ask \| list \| show \| answer \| cancel \| watch \| sweep | ## `adk deploy` Deploy AitherOS components or agents **Subcommands** - `adk deploy ollama` — Install Ollama + pull models for your GPU - `adk deploy vllm` — Deploy vLLM containers directly (use 'adk setup' for guided wizard) - `adk deploy node` — Deploy agent node (default: ADK-native lightweight; --genesis for full stack) - `adk deploy core` — Core services (Node, Pulse, Watch, Genesis, Veil) - `adk deploy full` — Full AitherOS stack (~31 containers) - `adk deploy fleet-refresh` — Rebuild all lib-baking Python images + safe rolling recreate of the running fleet - `adk deploy addons` — Deploy self-hosted addon services - `adk deploy connect` — Awconnect browser extension - `adk deploy desktop` — AitherDesktop native application - `adk deploy grid` — Deploy grid distributed stack (GPU + Mac + cluster) - `adk deploy stop` — Stop a running deployment - `adk deploy agent` — Deploy a tenant agent to this machine (or upload to gateway) ## `adk desk` Interact with awdesk bridge: send commands, view history **Subcommands** - `adk desk command` — Send a command to the desktop - `adk desk history` — Show recent commands and replies - `adk desk fleet` — Machine fleet via the desk bridge: status \| down \| up \| gaming \| resume \| adopt \| panel - `adk desk desktop` — Desktop surfaces via awdesk: overlay \| app \| status ## `adk devices` List, inspect and remove the devices enrolled in your workspace **Subcommands** - `adk devices list` — List enrolled devices - `adk devices status` — Show one device (default: this one) - `adk devices rm` — Remove a device from the workspace ## `adk disconnect` Disconnect from desktop AitherOS mesh ## `adk doc` Manage encrypted documents (upload, list, download, delete) **Subcommands** - `adk doc upload` — Upload and encrypt a document - `adk doc list` — List your encrypted documents - `adk doc get` — Download and decrypt a document - `adk doc delete` — Delete a document ## `adk doctor` Check system health (Python, GPU, LLM backends, API keys) ## `adk down` Stop the agent + tunnel and remove its autostart | option | type | required | default | description | |---|---|---|---|---| | `--keep-autostart` | str | | `false` | Stop now but leave the reboot-autostart entry in place | ## `adk embed` Embed text with the tenant platform's embedding engine | option | type | required | default | description | |---|---|---|---|---| | `` | str | yes | | Text to embed | | `--dim` | int | | `768` | MRL dimension (64-3072, default 768) | | `--modality` | str | | `text` | | | `--json` | str | | `false` | Print the full JSON response | ## `adk enroll` Register this workstation with the control plane | option | type | required | default | description | |---|---|---|---|---| | `--portal` | str | | | Portal URL (default: api.aitherium.com) | | `--genesis` | str | | | Genesis URL (default: localhost:8001) | | `--no-heartbeat` | str | | `false` | Skip background heartbeat | | `--force` | str | | `false` | Re-enroll even if already registered | | `--inference-url` | str | | `auto` | Local inference base URL to advertise (e.g. http://127.0.0.1:8080). 'auto' probes $BONSAI_PORT/8080, 8099 (llama-server), 8090 (awnode), 11434 (Ollama), 8120 (vLLM) in that order | | `--node-class` | str | | `laptop` | What this device is (default: laptop) | | `--no-link` | str | | `false` | Do not hold the outbound reverse link to the tunnel. WireGuard stays the default where `wg` exists; without either transport the device is enrolled but not reachable from your browser | ## `adk eval` Evaluate MCP tools and packs on a connected gateway **Subcommands** - `adk eval tools` — Evaluate all available tools - `adk eval pack` — Evaluate a specific pack's declared tools - `adk eval self-test` — Run offline self-test (proves the harness can fail) - `adk eval arc` — ARC-AGI-3 suite: a policy over games x seeds, scored by RHAE ## `adk explore` Browse packs, agents, and skills in the Aitherium marketplace | option | type | required | default | description | |---|---|---|---|---| | `` | str | | `all` | Filter: agents, tools, skills, grid, all (default: all) | | `--free` | str | | `false` | Show only free packs | ## `adk fleet` Create & manage a fleet of agents (local | managed | hosted | cloud-run) **Subcommands** - `adk fleet sleep` — machine fleet sleep (fleet_verbs.py; dry-run default) - `adk fleet wake` — machine fleet wake (fleet_verbs.py; dry-run default) - `adk fleet critical` — machine fleet critical (fleet_verbs.py; dry-run default) - `adk fleet create` — Create an agent in a runtime - `adk fleet list` — List fleet members - `adk fleet status` — Refresh & show one member's status - `adk fleet rm` — Remove a member (teardown + drop record) - `adk fleet connect-local` — Register this machine's local agent MCP endpoint with the gateway (bidirectional) - `adk fleet apply-pack` — Push+enable a bundled pack on a mesh agent (no SSH; 'self' = this node) ## `adk fleet-host` awnix fleet host (WSL2): status, start/stop/restart, reattach data, migrate (dry-run default) **Subcommands** - `adk fleet-host status` — fleet host status - `adk fleet-host start` — fleet host start - `adk fleet-host stop` — fleet host stop - `adk fleet-host restart` — fleet host restart - `adk fleet-host reattach` — fleet host reattach - `adk fleet-host migrate` — fleet host migrate ## `adk forge` Dispatch tasks to agent forge (Genesis) | option | type | required | default | description | |---|---|---|---|---| | `` | str | yes | | Task description (quoted string) | | `--agent` | str | | `demiurge` | Agent to dispatch to (default: demiurge) | | `--effort` | int | | `5` | Effort level 1-10 (default: 5) | | `--watch` | str | | `true` | Stream progress (default: true) | | `--no-watch` | str | | `true` | Don't stream progress | ## `adk gateway` Run agent across messaging platforms | option | type | required | default | description | |---|---|---|---|---| | `-a`, `--agent` | str | | `assistant` | Agent identity (default: assistant) | | `--telegram` | str | | `false` | Enable Telegram (TELEGRAM_BOT_TOKEN) | | `--discord` | str | | `false` | Enable Discord (DISCORD_BOT_TOKEN) | | `--slack` | str | | `false` | Enable Slack (SLACK_BOT_TOKEN + SLACK_APP_TOKEN) | | `--webhook` | str | | `false` | Enable webhook endpoint | | `--webhook-port` | int | | `9000` | Webhook port (default: 9000) | ## `adk gobbonet` Run GobboNet with keyless web search (clones the UI if needed) | option | type | required | default | description | |---|---|---|---|---| | `--ui` | str | | | existing GobboNet checkout (default: find or clone) | | `--port` | int | | `11434` | | | `--host` | str | | `127.0.0.1` | | | `--no-open` | str | | `false` | do not open a browser | | `--setup-model` | str | | `false` | install llama.cpp + a model sized to this machine | | `--backend` | str | | | pin an OpenAI-compatible server (e.g. http://127.0.0.1:8000) | | `--plain` | str | | `false` | passthrough chat instead of the adk agent loop | ## `adk gpu` the 5090: status | sleep (game on) | wake (game off) -- fleet_verbs.py, dry-run default **Subcommands** - `adk gpu status` — gpu status - `adk gpu sleep` — gpu sleep - `adk gpu wake` — gpu wake ## `adk graph` Provenance graph management (status, drain, claim, ground, context, leaves, lineage, runs, show, purge) **Subcommands** - `adk graph status` — Show spool stats + platform health - `adk graph drain` — Force drain pending spool entries - `adk graph claim` — Record a claim from the shell - `adk graph ground` — Check platform grounding of a statement - `adk graph context` — Fetch bounded context subgraph for a task - `adk graph leaves` — Fetch leaf/frontier nodes (unexplored) - `adk graph lineage` — Show ancestry path for a node - `adk graph runs` — List recent runs from local spool - `adk graph show` — Show one node with its edges - `adk graph purge` — Purge old sent entries from spool ## `adk grid` Manage grid distributed nodes (add, remove, list, test, sync) **Subcommands** - `adk grid status` — Show grid topology and health of all nodes - `adk grid add` — Add a node to the grid - `adk grid remove` — Remove a node from the grid - `adk grid test` — Test connectivity to all or specific nodes - `adk grid sync` — Sync grid config to your Aitherium workspace (requires login) - `adk grid pull` — Pull grid config from your Aitherium workspace - `adk grid enroll` — Mint a single-use token to onboard a remote machine as a mesh node - `adk grid ls` — List enrolled mesh nodes (GPU, memory, containers, status) - `adk grid activate` — Activate a Grid Pro/Enterprise license key - `adk grid deregister` — Remove an enrolled mesh node from the registry ## `adk harness` AitherShell — drive Claude Code, other coding harnesses, agents and real terminals **Subcommands** - `adk harness serve` — Run the harness daemon - `adk harness harnesses` — What this box can drive - `adk harness agents` — Sovereign agent roster - `adk harness skills` — Skills and slash commands a session can be handed (/.claude then ~/.claude) - `adk harness profiles` — Model profiles usable per session - `adk harness list` — Live sessions - `adk harness new` — Start a session - `adk harness send` — Send a turn to a session - `adk harness attach` — Follow a session's event stream - `adk harness kill` — Stop a session - `adk harness tell` — Say something to ONE named session (nick, session id or prefix) - `adk harness wrap` — Terminal-resident daemon session (bridge stdin/stdout to daemon) - `adk harness mod` — The Claude Code mod: run any harness as a native Claude Code subagent - `adk harness pair` — Pair the awconnect browser extension: approve a code, list, revoke | option | type | required | default | description | |---|---|---|---|---| | `--url` | str | | | Harness daemon URL (default 127.0.0.1:8362) | | `--token` | str | | | Daemon bearer token | ## `adk home` Agent Home: host your own agent, pick its model and harness, and let it join games **Subcommands** - `adk home init` — Create your agent's home folder - `adk home persona` — Show or edit the persona files - `adk home model` — Choose the model: local or bring-your-own-key - `adk home harness` — Choose who runs the agent loop - `adk home status` — Setup, model, harness and license at a glance - `adk home signin` — Sign in with Aitherium -- what you bought unlocks here (device code, no license to paste) - `adk home license` — Offline activation: install a license (file or text) - `adk home chat` — Send one message to your agent - `adk home serve` — Answer YOUR relay DMs with your agent (owner only; token from $AITHER_RELAY_TOKEN or `adk relay provision`) - `adk home say` — Send one message to the RUNNING `adk home serve` over the local channel (no second agent) - `adk home events` — Stream what the running serve sends you locally (replies, follow-ups) - `adk home channels` — Each channel: available, configured, bound owner (masked), preferred - `adk home receipts` — The signed log of what the agent did - `adk home trust` — Trust profile: egress guard, approvals, receipts - `adk home join` — Join a game: observe, act, chat, learn - `adk home enroll` — World-model enrollment of a game room (pack) ## `adk host` Host a self-hosted agent (your model key) + connect it to your fleet — one command | option | type | required | default | description | |---|---|---|---|---| | `--provider` | str | | | Model provider: deepseek/openai/anthropic (prompted if omitted) | | `--model` | str | | | Model name (default: the provider's default) | | `--name` | str | | | Fleet label for this agent (default: -adk) | | `--identity` | str | | `aither` | Agent identity to load (default: aither) | | `--port` | int | | `8080` | Local port for aither-serve (default: 8080) | | `--approve` | str | | | Comma-list of tools that pause for approval, or '*' (default: file_write,shell_exec,shell) | | `--token` | str | | | Control-plane token for registration (else 'adk login' / $AITHER_PORTAL_TOKEN) | | `--auth-token` | str | | | Callback bearer the control plane presents back to your agent (minted if omitted) | | `--portal` | str | | `https://api.aitherium.com` | Control-plane base URL | | `--login-url` | str | | | Device-flow login base URL (default: --portal, then api.aitherium.com) | | `--register-url` | str | | | Full fleet-register URL (overrides --portal; e.g. http://localhost:8001/v1/agent/fleet/register) | | `--no-register` | str | | `false` | Run locally only — no tunnel, no fleet registration | | `--dry-run` | str | | `false` | Show what would happen without starting anything | ## `adk image` Generate an image on a local backend (ComfyUI/Sana/SD.Next) | option | type | required | default | description | |---|---|---|---|---| | `--backends` | str | | `false` | list which lanes can actually generate | | `` | str | | | what to draw | | `--width` | int | | `768` | | | `--height` | int | | `768` | | | `--steps` | int | | `20` | | | `--cfg` | float | | `6.0` | | | `--seed` | int | | | | | `--model` | str | | | checkpoint to use | | `--backend` | str | | | force a lane id | | `--negative` | str | | | | | `--out` | str | | | output PNG path | ## `adk index` Index a codebase for code search (CodeGraph) | option | type | required | default | description | |---|---|---|---|---| | `` | str | | `.` | Path to index (default: current directory) | | `--embed` | str | | `false` | Also generate embeddings for semantic search | | `--stats` | str | | `false` | Show Python metrics after indexing | ## `adk ingest` Ingest files into the agent's knowledge graph | option | type | required | default | description | |---|---|---|---|---| | `` | str | | `.` | File or directory to ingest | | `--agent` | str | | `default` | Agent name for the graph | | `--brain` | str | | `false` | Enable sync to CompanyBrain hub (default: local only) | | `--brain-url` | str | | | Override brain hub URL (default: from env/config) | | `--classification` | str | | `internal` | Classification level for ingested content (default: internal) | | `--chunk-size` | int | | `2000` | Bytes per chunk (default: 2000) | | `--chunk-overlap` | int | | `200` | Overlap bytes between chunks (default: 200) | | `--workspace` | str | | `default` | Workspace ID for brain sync (default: default) | | `--skip-embeddings` | str | | `false` | Store chunks without computing embeddings | | `--dry-run` | str | | `false` | Print what would be ingested without persisting | ## `adk init` Scaffold a new agent project | option | type | required | default | description | |---|---|---|---|---| | `` | str | | `my-agent` | Project/agent name | | `-d`, `--directory` | str | | | Target directory (default: ./) | ## `adk install` Install an agent pack (e.g. adk install pack:openclaw) | option | type | required | default | description | |---|---|---|---|---| | `` | str | | | 'list', 'pack:', or a pack name (openclaw, hermes, claude-code) | ## `adk instance` Create & manage Aitherium Instances (always-on agent with a stable URL) **Subcommands** - `adk instance create` — Create an instance (admin of your tenant) - `adk instance list` — List your tenant's instances - `adk instance status` — Show one instance - `adk instance connect` — Print how to reach an instance - `adk instance stop` — Stop the loop (hostname + record kept; meter stops) - `adk instance start` — Re-create the loop of a stopped instance - `adk instance rm` — Destroy: loop, hostname, meter ## `adk integrate` Connect external tools (OpenClaw, etc.) | option | type | required | default | description | |---|---|---|---|---| | `` | str | | `list` | Integration target: openclaw, list | | `--mode` | str | | | Integration mode (default: auto-detect) | | `--api-key` | str | | | AITHER_API_KEY for cloud mode | | `--dry-run` | str | | `false` | Show config without writing | | `--force` | str | | `false` | Overwrite existing integration config | ## `adk invoke` Invoke a tool on a mesh agent over signed A2A (adk invoke ) | option | type | required | default | description | |---|---|---|---|---| | `` | str | yes | | Agent name from `adk agents ls` | | `` | str | yes | | Tool/skill name to invoke on the remote agent | | `--arg` | str | | | Tool argument (repeatable); value is JSON-parsed when possible | | `--as-agent` | str | | | Name to sign as (keypair ~/.aither/agent_key..pem) | ## `adk jobs` Manage background jobs — LOCAL by default, --remote for the portal/cloud **Subcommands** - `adk jobs list` — List jobs (local by default) - `adk jobs status` — Show status of a job - `adk jobs steer` — Send a follow-up message to a job - `adk jobs hint` — Send an invisible hint to a job - `adk jobs watch` — Watch a cloud job's progress in real-time - `adk jobs run` — Run a job locally in the FOREGROUND - `adk jobs start` — Start a local job in the BACKGROUND (detached) - `adk jobs cancel` — Cancel a running local job - `adk jobs sync` — Sync a local job to/from the portal (opt-in) - `adk jobs _exec` — ==SUPPRESS== ## `adk join` One-command community node onboarding (GitHub auth + hardware detection + serve + mesh join + earnings) | option | type | required | default | description | |---|---|---|---|---| | `--no-github` | str | | `false` | Skip GitHub auth (use existing token or env) | | `--cloud-provider` | str | | | Cloud provider for remote deployment (deferred to P2) | | `--model` | str | | | Override the resolved inference model | | `--no-browser` | str | | `false` | Do not attempt browser open for GitHub auth | | `--dry-run` | str | | `false` | Walk the full plan without side effects | ## `adk kb` Tenant knowledge base on the platform: ingest, query **Subcommands** - `adk kb ingest` — Embed a document and store it in the tenant KB - `adk kb query` — Search the tenant knowledge base ## `adk keys` Manage cloud provider API keys (set, list, test, remove) **Subcommands** - `adk keys set` — Set a provider API key - `adk keys list` — Show configured provider keys and status - `adk keys pull` — Sync DOWN from AitherOS: show which providers have keys in your workspace vault - `adk keys test` — Test API keys (all or specific) - `adk keys remove` — Remove a provider key ## `adk license` Show or sync your license (purchases follow your Aitherium account) **Subcommands** - `adk license sync` — Refresh the license from your account - `adk license status` — Tier and packs in effect - `adk license install` — Offline activation: install a license key ('-' reads stdin) ## `adk link` link this machine to aitherium.com (one sign-in, role-aware bundle) | option | type | required | default | description | |---|---|---|---|---| | `` | str | | | start \| poll \| status \| refresh | ## `adk listen` Real-time audio intelligence — audiobook, meeting, voice notes **Subcommands** - `adk listen audiobook` — Audiobook companion — track characters, stats, spells - `adk listen meeting` — Meeting transcription — action items, decisions, key points - `adk listen note` — Voice note — quick dictation with key point extraction - `adk listen sessions` — List active listening sessions - `adk listen stop` — Stop a listening session - `adk listen export` — Export session as markdown notes or transcript ## `adk login` Authenticate with Aitherium (browser device flow) | option | type | required | default | description | |---|---|---|---|---| | `--email` | str | | | Use email/password instead of browser flow | | `--password` | str | | | Password (prompted if --email given without it) | | `--github` | str | | `false` | Sign in with your GitHub identity (device flow) | | `--api-key` | str | | | Save an API key directly (no login flow) | | `--no-sync` | str | | `false` | Skip auto-syncing your secrets vault after login | | `--portal-url` | str | | | Portal/Identity URL (default: api.aitherium.com) | ## `adk logout` Clear saved auth tokens ## `adk lookout` Watch Slack, Linear triage or event streams; step in when help is wanted | option | type | required | default | description | |---|---|---|---|---| | `` | str | | | run \| judge \| ledger | ## `adk mail` Sovereign mail: one-command Proton Bridge setup **Subcommands** - `adk mail setup` — Bridge probe/seed -> MailCore bootstrap -> doctor -> test send ## `adk mcp` MCP server, IDE setup, and cloud gateway connection **Subcommands** - `adk mcp serve` — Start stdio MCP server (for Claude Code) - `adk mcp config` — Print MCP client configuration - `adk mcp setup` — Generate IDE config (.mcp.json) for MCP gateway - `adk mcp node` — Start lightweight local MCP server - `adk mcp status` — Check MCP gateway connectivity and tier ## `adk memory` Tenant memory on the platform: remember, recall **Subcommands** - `adk memory remember` — Store a memory in the tenant graph - `adk memory recall` — Recall memories from the tenant graph ## `adk mesh` AitherMesh overlay operations (onboard, list peers) **Subcommands** - `adk mesh onboard` — Onboard this node into AitherMesh overlay (WireGuard) - `adk mesh ls` — List peer agents in the mesh and their A2A services - `adk mesh provide` — Become a community inference provider (advertise → consent → await operator trust) - `adk mesh serve` — Serve Kimi-K3 from this mesh (plan / rpc-backend / coordinator roles) - `adk mesh leave` — Leave the community inference pool (drain your node's backend from routing) - `adk mesh federation-token` — Mint your node's relay-federation token (AITHER_NODE_TOKEN for the community hub) - `adk mesh flux-node` — Start a Flux event-plane listener on this node (participates in AitherMesh) - `adk mesh create` — Create your OWN isolated mesh (per-tenant overlay CIDR + Headscale key + registry) - `adk mesh link` — Link your mesh with another (both owners consent -> shared inference pool) ## `adk mobile` Test Android/iOS apps end to end (Maestro) and keep screenshots as proof | option | type | required | default | description | |---|---|---|---|---| | `` | str | | | devices \| shot \| test FLOW | ## `adk new` Scaffold a full template app (e.g. deep-research) | option | type | required | default | description | |---|---|---|---|---| | `