CLI Reference

Install: npm install -g @parel/cli (Node.js >= 22)

# parel login

Authenticate with your API key. Get one from Console > Settings.

▓ shell

parel login
# API key: pk_your_key_here
# Logged in.
#   server: https://api.parel.sh
#   key:    pk_your...here

# Check status
parel whoami

# parel config

▓ shell

parel config set --server https://api.parel.sh --key pk_your_key
parel config show

# parel deploy

Deploy an agent from a YAML config file.

▓ shell

parel deploy agent.yaml
# Deployed: my-agent
#   id: agent_a1b2c3d4

# parel agents

▓ shell

parel agents list              # List all agents
parel agents list --json       # JSON output
parel agents get agent_abc123  # Agent details
parel agents update agent_abc123 --file agent.yaml
parel agents delete agent_abc123

# parel sessions

▓ shell

parel sessions list
parel sessions list --agent agent_abc123 --status running
parel sessions create agent_abc123
parel sessions get <session-id>
parel sessions history <session-id>

# parel chat

Interactive chat with streaming via WebSocket. Creates a session or resumes an existing one.

▓ shell

# New session
parel chat --agent agent_abc123

# Resume session
parel chat --session <session-id>

# Inside chat:
$ hello
▸ Hi! How can I help?
$ /history    # show conversation log
$ /quit       # exit

# parel logs

Show events and logs for a session.

▓ shell

parel logs <session-id>

# parel steer

Redirect a running session mid-execution.

▓ shell

parel steer --session <session-id> "Focus on AI posts only"

# parel api-keys

▓ shell

parel api-keys list
parel api-keys create my-key
parel api-keys delete key_abc123

# parel billing

▓ shell

parel billing summary
parel billing balance

# Global Options

Flag	Description
--server <url>	Override API server URL
--json	Machine-readable JSON output (list commands)