CLI
Code
# Agent A spawns Agent B and waits for it
amadev run --detach "implement the API" --name api-agent
amadev wait api-agent
amadev logs api-agent --tail 5
Simple implement + verify loop:
Code
# Requires jq
while true; do
amadev run --provider codex "make the tests pass" >/dev/null
verdict=$(amadev run --provider claude --output-schema '{"type":"object","properties":{"criteria_met":{"type":"boolean"}},"required":["criteria_met"],"additionalProperties":false}' "ensure tests all pass")
if echo "$verdict" | jq -e '.criteria_met == true' >/dev/null; then
echo "criteria met"
break
fi
done
This pattern enables hierarchical task decomposition, a lead agent can break down work, delegate to specialists, and synthesize results.
Output formats
Most commands support multiple output formats for scripting:
Code
amadev ls --json # JSON output
amadev ls --format yaml # YAML output
amadev ls -q # IDs only (quiet)
Global options
--host <target>, connect to a different daemon (host:port, unix socket, or https://app.amadev.org/#offer=... for relay). See Connecting to a remote daemon.--json, JSON output-q,--quiet, minimal output--no-color, disable colors