agno-cli

agno-cli

A Node.js/TypeScript CLI for managing and interacting with Agno AgentOS instances. Built on top of the @worksofadam/agentos-sdk, it provides full coverage of the AgentOS API -- agents, teams, workflows, sessions, traces, knowledge, memories, evals, metrics, schedules, approvals, and more.

Designed for both human operators and AI agent automation, with JSON output and piping support that lets you chain commands together in shell scripts and pipelines.

Quick Start

Install

npm install -g agno-cli

Or run directly without installing:

npx agno-cli

Requires Node.js >= 20.

Configure

Point the CLI at your AgentOS instance:

# Initialize with defaults (localhost:7777)
agno-cli config init

# Or specify your server URL
agno-cli config init --url http://localhost:8000

# With a security key
agno-cli config init --url https://my-agentos.example.com --key sk-your-key-here

Verify connection

agno-cli status

Run your first agent

# List available agents
agno-cli agent list

# Run one
agno-cli agent run my-agent "Hello, what can you do?"

# Stream the response in real-time
agno-cli agent run my-agent "Summarize this data" --stream

Use with Claude Code (skill)

This repo doubles as a Claude Code plugin marketplace exposing the agno-cli skill, which teaches Claude how to drive a running AgentOS server with this CLI -- inspecting traces, listing/running agents and teams, managing knowledge and sessions, and more.

Via the Claude Code marketplace:

claude plugin marketplace add ajshedivy/agno-cli
claude plugin install agno-cli@agno-cli

Via npx skills:

npx skills add ajshedivy/agno-cli

Once installed, Claude activates the skill automatically based on context -- e.g. "check AgentOS status", "list my agents", "inspect that trace" -- or you can invoke it explicitly as /agno-cli:agno-cli.

Configuration

Config lives at ~/.agno/config.yaml. You can manage multiple server contexts and switch between them.

# Add a production context
agno-cli config add production --url https://prod.example.com --key sk-prod-key

# Switch to it
agno-cli config use production

# See what's active
agno-cli config show

# List all contexts
agno-cli config list

Environment Variable Overrides

These take precedence over the config file:

Variable	Description
AGNO_CONTEXT	Override active context name
AGNO_BASE_URL	Override base URL
AGNO_SECURITY_KEY	Override security key
AGNO_TIMEOUT	Override timeout (seconds)

Global Options

These work with any command:

-V, --version              Show version
-c, --context <name>       Override active context
--url <url>                Override base URL
--key <key>                Override security key
--timeout <seconds>        Override timeout
--no-color                 Disable color output
--json [fields]            Output JSON (optional field selection: --json id,name)
-o, --output <format>      Output format: json | table

Output format auto-detects: table when interactive, JSON when piped.

Command Reference

status

Show AgentOS server info and resource counts.

agno-cli status

agent

Manage and run agents.

agno-cli agent list [--limit N] [--page N]
agno-cli agent get <agent_id>
agno-cli agent run <agent_id> <message> [-s|--stream] [--session-id ID] [--user-id ID]
agno-cli agent continue <agent_id> <run_id> [tool_results] [-s|--stream] [--confirm] [--reject [note]]
agno-cli agent cancel <agent_id> <run_id>

The continue command handles paused runs (e.g., tool approval). Paused state is cached locally, so --confirm and --reject work without re-supplying tool results.

team

Manage and run teams.

agno-cli team list [--limit N] [--page N]
agno-cli team get <team_id>
agno-cli team run <team_id> <message> [-s|--stream] [--session-id ID] [--user-id ID]
agno-cli team continue <team_id> <run_id> <message> [-s|--stream]
agno-cli team cancel <team_id> <run_id>

workflow

Manage and run workflows.

agno-cli workflow list [--limit N] [--page N]
agno-cli workflow get <workflow_id>
agno-cli workflow run <workflow_id> <message> [-s|--stream] [--session-id ID] [--user-id ID]
agno-cli workflow continue <workflow_id> <run_id> <message> [-s|--stream]
agno-cli workflow cancel <workflow_id> <run_id>

session

Manage conversation sessions.