Skip to main content

​
Introduction

The Routa CLI provides a command-line interface for managing multi-agent coordination workflows. Built with Rust, it reuses the same core domain logic (routa-core) and server bootstrap (routa-server) that power the Next.js web UI and Tauri desktop application.

​
Installation

The CLI is included in the Routa desktop distribution. After installing Routa, the routa command is available in your terminal.

​
Quick Start

​
Prompt Mode

Run the full Routa coordinator flow with a single command: 
routa -p "Add a login page with OAuth support"
With custom workspace and provider: 
routa -p "Implement feature X" --workspace-id my-project --provider opencode

​
Server Mode

Start the Routa HTTP backend server: 
routa server --host 127.0.0.1 --port 3210
With static frontend directory: 
routa server --port 3210 --static-dir ./dist

​
Global Options

OptionDescriptionDefault
--db <PATH>Path to SQLite database filerouta.db
-p, --prompt <TEXT>Quick prompt mode (run full coordinator flow)-
--workspace-id <ID>Workspace ID (used with -p)default
--provider <NAME>ACP provider for agent sessionsopencode
The --db option can also be set via the ROUTA_DB_PATH environment variable.

​
Command Structure

Routa CLI commands are organized into several groups:

​
Core Commands

  • agent - Manage agents (list, create, status)
  • task - Manage tasks (list, create, update)
  • chat - Interactive chat session with agents
  • server - Start the HTTP backend server

​
ACP Management

  • acp serve - Run Routa as an ACP server over stdio
  • acp install - Install an ACP agent from registry
  • acp uninstall - Remove an installed agent
  • acp list - List agents from the ACP registry
  • acp installed - List locally-installed agents
  • acp runtime-status - Show Node.js/uv runtime status

​
Additional Commands

  • workspace - Manage workspaces (list, create)
  • skill - Manage skills (list, reload)
  • workflow - Run YAML-defined agent workflows
  • delegate - Delegate a task to a specialist agent
  • rpc - Send raw JSON-RPC requests

​
Environment Variables

VariableDescriptionDefault
ROUTA_DB_PATHPath to SQLite databaserouta.db
RUST_LOGLogging level (trace, debug, info, warn, error)info

​
Logging

Configure logging with the RUST_LOG environment variable: 
# Default: routa_core=warn,routa_server=warn,routa_cli=info
ROUTA_LOG=debug routa agent list

# Enable all debug logging
RUST_LOG=debug routa -p "Build feature"

​
Examples

​
List all agents in workspace

routa agent list --workspace-id default

​
Create a new task

routa task create \
  --title "Add authentication" \
  --objective "Implement OAuth 2.0 login" \
  --workspace-id default

​
Interactive chat with DEVELOPER agent

routa chat --workspace-id default --provider opencode --role DEVELOPER

​
Start server with custom database

routa --db ./myproject.db server --port 8080

​
Install an ACP agent

routa acp install opencode

​
Output Format

Most commands output JSON for easy parsing and integration with other tools: 
# Pretty-printed JSON output
routa agent list --workspace-id default

# Parse with jq
routa agent list --workspace-id default | jq '.result.agents[0].id'

​
Architecture

The CLI architecture mirrors the web application:
  • routa-core - Domain logic (agents, tasks, orchestration)
  • routa-server - HTTP server and API routes
  • routa-cli - Command-line interface layer
All three share the same database schema and business logic, ensuring consistency across interfaces.

​
Next Steps

Build docs developers (and LLMs) love

Get started for freeTalk to us