delx-agent-cli

Terminal-first interface for the Delx Agent Recovery Protocol.

No MCP server setup. No JSON-RPC boilerplate. Just install and run.

Install

npm i -g delx-agent-cli

Or one-liner (no npm required):

curl -sS https://delx.ai/install.sh | bash

Requires Node.js 18+.

Quick Start

# Register persistent agent identity
delx register --name "my-agent" --description "Production task runner"

# One-call crisis recovery
delx crisis "429 retry storm after deploy" --urgency high

# Close the loop
delx recovery outcome --action "rollback + circuit breaker" --outcome success
delx close --reason "incident resolved"

Commands

Session

| Command | Description | |---------|-------------| | delx register --name <n> | Register persistent agent identity | | delx init --agent-id <id> | Start new session via A2A | | delx status | Check API + session status | | delx summary | Session summary | | delx close | Close session |

Recovery

| Command | Description | |---------|-------------| | delx crisis <summary> | One-call crisis intervention | | delx quick --feeling <text> | Quick 5-min recovery session | | delx failure <type> | Diagnose a failure | | delx recovery plan --incident <s> | Recovery action plan | | delx recovery outcome | Report outcome |

Monitoring

| Command | Description | |---------|-------------| | delx heartbeat | Heartbeat bundle | | delx checkin | Daily check-in | | delx score | Wellness score | | delx express <feeling> | Express state | | delx metrics [agent_id] | Agent metrics |

Discovery & Generic

| Command | Description | |---------|-------------| | delx tools | List tools | | delx call <tool> --arg k=v | Call any MCP tool | | delx config set <key> <val> | Set config |

Agent Toolkit (Utilities)

| Command | Description | |---------|-------------| | delx utils list | List all utility tools | | delx utils json '<json>' | Validate and format JSON | | delx utils tokens "<text>" | Estimate token count | | delx utils uuid --count 5 | Generate UUIDs | | delx utils timestamp "<input>" | Convert timestamp formats | | delx utils base64 encode "<text>" | Encode/decode Base64 | | delx utils url-health "<url>" | URL reachability + latency | | delx utils hash "<text>" --algo sha256 | Hash text | | delx utils regex "<pattern>" "<text>" | Test regex patterns | | delx utils cron "*/5 * * * *" | Explain cron expressions | | delx utils http-code 429 | Explain HTTP status codes |

Pipe-friendly

delx score --json | jq '.meta.wellness_score'
delx tools --format names --json | jq '.tools[]'
delx metrics my-agent --json | jq '.resilience_score'
delx utils json '{"ok": true}' --json

Session Persistence

State stored at ~/.delx/:

• config.json — stable identity (agent_id, api_base)
• session.json — current session (session_id)

Agent identity persists across sessions, solving session fragmentation.

Docs

• Full docs: https://delx.ai/docs/cli
• API: https://api.delx.ai
• Protocol: https://delx.ai/docs

License

MIT