Skip to main content
The Reminix CLI supports JSON output on every command, making it easy to use in shell scripts and automation.

​
Invoke agents

Call any deployed agent from the command line. 
# One-shot invocation
reminix agent invoke support-bot --prompt "How do I reset my password?"

# Stream the response token by token
reminix agent invoke support-bot --prompt "Summarize this report" --stream

# Multi-turn chat
reminix agent chat support-bot --message "Hello"

# With conversation history
reminix agent chat support-bot \
  --message "What about pricing?" \
  --history '[{"role": "user", "content": "Hello"}, {"role": "assistant", "content": "Hi! How can I help?"}]'

# Structured input
reminix agent invoke analyzer --input '{"data": [1, 2, 3]}' --stream
Use --verbose to see execution ID, status, duration, and a link to the logs dashboard: 
reminix agent invoke support-bot --prompt "Hello" -v

​
Run workflows

Start and manage workflow runs from the command line. 
# Start a workflow
reminix agent workflow approval-flow -i '{"request": "Deploy to prod"}'

# Stream workflow progress
reminix agent workflow approval-flow -i '{"request": "Deploy to prod"}' --stream

# List workflow runs
reminix workflow list
reminix workflow list --agent approval-flow --status paused

# Check a specific run
reminix workflow show run_abc123

# Resume a paused workflow (e.g. approve a step)
reminix workflow resume run_abc123 -i '{"approved": true}'

​
Call tools

Call any deployed tool with JSON input. 
# Call a tool
reminix tool call lookup_customer -i '{"email": "user@example.com"}'

# Verbose mode shows execution details
reminix tool call create_ticket -i '{"subject": "Bug report", "body": "Login fails"}' -v

# List available tools
reminix tool list

​
JSON output

Every command supports -o json for machine-readable output. This makes it easy to pipe results into other commands. 
# Get agent response as JSON
reminix agent invoke support-bot --prompt "Hello" -o json | jq '.output'

# List agents as JSON
reminix agent list -o json | jq '.[].name'

# Call a tool and extract a field
reminix tool call lookup_customer -i '{"email": "user@example.com"}' -o json | jq '.id'

​
Shell scripts

Use the CLI in bash scripts for automation. 
#!/bin/bash
# Process a batch of support tickets

for ticket_id in $(cat ticket_ids.txt); do
  echo "Processing ticket $ticket_id..."

  # Look up ticket details
  TICKET=$(reminix tool call get_ticket \
    -i "{\"id\": \"$ticket_id\"}" -o json)

  SUBJECT=$(echo "$TICKET" | jq -r '.subject')

  # Generate a response
  RESPONSE=$(reminix agent invoke support-bot \
    --prompt "Draft a response for: $SUBJECT" -o json)

  echo "$RESPONSE" | jq -r '.output' >> responses.txt
done

​
View execution logs

Track and debug agent invocations, chats, and tool executions. 
# List recent logs
reminix log list

# Filter by type, status, or name
reminix log list --type agent_invoke --status error
reminix log list --name support-bot --source cli

# View details of a specific execution
reminix log show log_abc123

​
View conversations

Browse chat history between users and agents. 
# List conversations
reminix conversation list
reminix conversation list --agent support-bot

# View a conversation with all messages
reminix conversation show conv_abc123

​
Check usage

Monitor project usage and available models. 
# Usage summary with per-model breakdown
reminix usage summary

# List available models
reminix usage models

​
Next steps

CI/CD

Run the CLI from GitHub Actions and other pipelines.

Coding Assistants

Use the CLI as a tool inside Claude Code, Cursor, and Windsurf.

CLI Reference

Every command and flag in one place.

Tasks

The interaction pattern behind agent invoke.