mohiit1502
0f7bfecf92
- Remove all legacy stub commands (agent-create-stub, plugin-install-stub, workflow-create-stub, policy-create-stub, system-status-stub, etc.) from agos.py — real API commands come exclusively from command_surface.py - Add `workflow delete` command (DELETE /workflows/:id, 204) - Fix `policy create`: add --effect, --action, --resource options; update default priority to 20 (minimum valid caller band); fix conditions payload - Add description to `integration` command group - Sync command_surface.py to match agos repo (canonical source) Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
agos-cli
The official command-line interface for AGOS — an agent orchestrator and runtime platform.
Installation
pip install -e .
This registers the agos console script globally.
Quick Start
# Authenticate with Armco IAM
agos login
# Check who you are
agos whoami
# Ask the platform a question
agos ask "What agents are currently running?"
# List agents
agos agent list
# Run a workflow
agos workflow run wf_123 --agent-id agent_123
Commands
| Command | Description |
|---|---|
agos login |
Authenticate via Armco IAM (PKCE browser flow) |
agos logout |
Clear the local session |
agos whoami |
Show current identity and tenant |
agos ask <prompt> |
Send a natural-language prompt to AGOS chat |
agos agent <subcommand> |
Manage agents (list, get, create, run, stop, delete) |
agos task <subcommand> |
Manage tasks (list, get, create, cancel, delete) |
agos workflow <subcommand> |
Manage workflows (list, get, create, run, status) |
agos plugin <subcommand> |
Manage plugins (list, search, install, enable, disable, uninstall) |
agos policy <subcommand> |
Manage policies (list, create, delete) |
agos integration <subcommand> |
Manage integrations (catalog, providers, instances, create, test) |
agos db <subcommand> |
Local database ops (bootstrap, seed, status) |
agos system <subcommand> |
System health and logs |
agos help [topic] |
Focused help for any command |
agos man [topic] |
Full interactive manual |
Configuration
The CLI reads API URL from the following env vars in order:
AGOS_CLI_API_URLAGOS_API_URLVITE_API_URLAGOS_BASE_URL- Default:
http://localhost:2000
Auth tokens are cached at ~/.agos/auth.json (mode 0600).
Development
# Clone and install in editable mode
git clone <repo>
cd agos-cli
pip install -e .
# Run directly
agos --help
Related Repos
- agos — backend runtime
- agos-client — React frontend