Reference
CLI Capability Matrix
Current CLI command coverage, MCP tool equivalents, and API-only surfaces in the AEGIS orchestrator.
CLI Capability Matrix
This page reflects the currently implemented aegis command surface and its relationship to the built-in MCP management tools.
Implemented Top-Level Commands
| Command | Subcommands / Shape |
|---|---|
aegis daemon | start, stop, status, install, uninstall |
aegis agent | deploy, list, show, remove, logs, generate --input ... |
aegis task | execute, status, logs, cancel, remove, list |
aegis workflow | validate, deploy, deploy --force, run, run --wait, list, executions list, executions get, signal, cancel, remove, describe, logs, delete, generate --input ... |
aegis node | init, join, leave, peers |
aegis config | show, validate, generate |
| stack lifecycle | init, up, down, restart, status, update, uninstall |
Output Contract
Structured output is available on commands that return a bounded result set. Use json or yaml for automation and text or table for terminal-oriented use.
| Command Group | Structured Output | Notes |
|---|---|---|
aegis daemon status | Yes | Summary object suitable for JSON/YAML. |
aegis agent list/show/deploy/remove | Yes | logs and generate --follow remain stream-oriented. |
aegis task execute/status/list/cancel/remove | Yes | logs and --follow modes remain stream-oriented. |
aegis workflow validate/deploy/deploy --force/run/run --wait/list/executions list/executions get/describe/delete | Yes | logs and generate --follow remain stream-oriented. |
aegis node init/join/peers | Yes | Finite bootstrap and inspection results. |
aegis config show/validate | Yes | config generate uses --out <path> instead of --output. |
aegis status | Yes | Local and cluster status both return summaries. |
aegis update | Yes | Returns a bounded refresh summary. |
aegis init, aegis up, aegis down, aegis restart, aegis uninstall | Mixed | Scriptable in non-interactive mode; interactive or teardown progress remains human-oriented. |
aegis agent logs, aegis task logs, aegis workflow logs | No | These are streaming commands and do not use the generic renderer. |
CLI ↔ MCP Tool Mapping
Only part of the CLI has a direct MCP management-tool equivalent today. Local stack lifecycle, daemon lifecycle, cluster-node commands, and local status checks remain CLI-only.
| CLI Command | MCP Tool | Purpose |
|---|---|---|
| Agent Management | ||
aegis agent list | aegis.agent.list | List all deployed agents |
aegis agent deploy | aegis.agent.create | Deploy a new agent |
aegis agent deploy --force | aegis.agent.update | Overwrite an existing name+version pair |
aegis agent show <uuid> | aegis.agent.export | Export agent manifest as a structured document |
aegis agent remove <id> | aegis.agent.delete | Permanently remove an agent |
aegis agent generate --input ... | aegis.agent.generate | Natural language agent authoring loop |
aegis agent logs <id> | aegis.agent.logs | Retrieve agent-level activity logs |
| Workflow Management | ||
aegis workflow list | aegis.workflow.list | List all registered workflows |
aegis workflow deploy | aegis.workflow.create | Validate and register a workflow |
aegis workflow deploy --force | aegis.workflow.create | Validate and overwrite an existing name+version pair |
aegis workflow validate | aegis.workflow.validate | Parse and deterministically validate a workflow manifest |
aegis workflow describe <name> | aegis.workflow.export | Export workflow manifest as a structured document |
aegis workflow delete <name> | aegis.workflow.delete | Remove a workflow from registry |
aegis workflow run <name> [--version <semver>] | aegis.workflow.run | Execute a registered workflow |
aegis workflow executions list | aegis.workflow.executions.list | List workflow executions with optional workflow filtering |
aegis workflow executions get | aegis.workflow.status / aegis.workflow.executions.get | Fetch a single workflow execution, including status and blackboard state |
aegis workflow generate --input ... | aegis.workflow.generate | Natural language workflow authoring loop |
aegis workflow logs <execution_id> | aegis.workflow.logs | Retrieve workflow execution event log |
aegis workflow cancel <id> | aegis.workflow.cancel | Cancel a running workflow execution |
aegis workflow signal <id> --response <text> | aegis.workflow.signal | Send human input to a paused workflow |
aegis workflow remove <id> | aegis.workflow.remove | Remove a workflow execution record |
| Task Management | ||
aegis task execute <agent> [--version <semver>] | aegis.task.execute | Execute an agent task |
aegis task status <execution_id> | aegis.task.status | Check execution progress and outcome |
aegis task wait <execution_id> [--timeout <seconds>] | aegis.task.wait | Block until execution reaches terminal state |
aegis task list | aegis.task.list | List recent task executions |
aegis task logs <execution_id> | aegis.task.logs | Retrieve task execution event log |
aegis task cancel <execution_id> | aegis.task.cancel | Stop a running execution |
aegis task remove <execution_id> | aegis.task.remove | Delete an execution record |
| System Management | ||
aegis daemon status | aegis.system.info | Closest MCP read-only system status equivalent |
aegis config show | aegis.system.config | View active node configuration |
The CLI also exposes commands with no current MCP counterpart:
aegis daemon start|stop|install|uninstallaegis init|up|down|restart|status|update|uninstallaegis node init|join|leave|peersaegis workflow run --wait
Context Override Support
The current CLI supports file-backed context dictionaries for direct execution and workflow startup:
| Command | Override Flag | Accepted Formats | Validation |
|---|---|---|---|
aegis task execute <agent> | --context <DICT> | Inline JSON/YAML or @file JSON/YAML | Must be an object; reserved execution keys are rejected by the orchestrator |
aegis task execute <agent> | --version <semver> | Semantic version string | Pins execution to a specific agent version; latest deployed version is used when omitted |
aegis workflow run <name> | --blackboard <DICT> | Inline JSON/YAML or @file JSON/YAML | Must be an object; reserved workflow keys such as workflow are rejected |
aegis workflow run <name> | --version <semver> | Semantic version string | Pins execution to a specific workflow version; latest deployed version is used when omitted |
aegis task execute --input and aegis workflow run --input also accept inline JSON/YAML or @file values, but those flags carry primary execution/workflow input rather than top-level context overrides.
For automation, prefer the CLI's structured --output contract on the commands above instead of parsing human-readable terminal output.
API-Only (No Dedicated CLI Subcommand Yet)
| Capability | API Path |
|---|---|
| Workflow execution status/detail | aegis.workflow.executions.get |
| Stimulus ingestion | POST /v1/stimuli, POST /v1/webhooks/{source} |
| Swarm-specific lifecycle operations | Use execution/event APIs and orchestration services |
| Volume-specific listing/deletion operations | Use storage/volume management APIs |