ARGUS — ArgusLabs

CLI Reference

Complete reference for all ARGUS CLI commands.

Overview

The ARGUS CLI is your interface for viewing runs, replaying executions, generating reports, and managing your workspace. Install it with pip install argus-agents — the CLI ships with the Python package.

bash
argus list                           # all runs
argus show last                      # most recent run
argus show run <id>                  # by full id or 8-char prefix
argus replay <id> <node>             # re-run from a node
argus replay <id> <node> --only      # re-run just that one node
argus inspect <id> --step <node>     # raw input/output for a node
argus diff <id>                      # rerun vs original
argus diff <id-a> <id-b>             # any two runs
argus ui                             # open web dashboard
argus doctor                         # check your setup
argus login                          # sign in for cloud sync
argus logout                         # clear credentials
argus whoami                         # check login status
argus update                         # check for new release

argus list

List all stored runs.

bash
# List all runs
argus list

argus show

View a specific run in your terminal. Shows the full trace with node statuses, timing, detections, and root cause analysis.

bash
# View the most recent run
argus show last

# View a specific run by ID (full or 8-char prefix)
argus show run abc12345

Example output:

text
argus  run-abc12345  ·  2024-04-05 12:30  ·  1243 ms
status  ●  silent_failure

   1  fetch       43 ms    ✓  pass
   2  validate    12 ms    ⚠  silent failure
      └─  Field "score" is missing
      └─  process received bad state
   3  process    891 ms    ✗  crashed
      └─  KeyError: 'score'
      └─  Field 'score' was absent from the incoming state

root cause   validate

Node Statuses

  • ✓ — pass
  • ~ — pass with warnings (empty optional fields)
  • ⚠ — silent failure (missing required fields)
  • ⊗ — semantic fail (validator returned False)
  • ⏸ — interrupted (human-in-the-loop pause)
  • ○ — skipped (conditional branch not taken)
  • ✗ — crashed

argus inspect

View the raw input/output state for a specific node in a run.

bash
# Inspect a specific node's raw data
argus inspect <id> --step <node>

argus replay

Re-execute a pipeline from a specific node. ARGUS restores the exact state at that node from disk and runs from there. Upstream outputs stay frozen — only the target node onward re-executes with your fixed code.

bash
# Replay from a specific node
argus replay <run-id> node_7

# Re-run just one node in isolation
argus replay <run-id> node_7 --only

All external HTTP calls (OpenAI, search tools, databases) are recorded by default. During replay, the recorded responses are served back — same data, zero extra cost, fully reproducible.

Replay requires persist_state

Replay only works on runs recorded with persist_state=True (the default). If state persistence was disabled, ARGUS doesn't have the intermediate states needed to replay.

argus diff

Compare two runs side by side. When a replay finishes, ARGUS automatically compares it against the original using an LLM — showing per-node diffs of what changed, what improved, and whether the fix actually worked.

bash
# Compare a rerun against its original
argus diff <rerun-id>

# Compare any two runs
argus diff <id-a> <id-b>

argus ui

Launch the local web dashboard in your browser. Serves runs from .argus/runs/ in your current directory — no account needed.

bash
# Launch the dashboard
argus ui

Opens at http://localhost:7842. The UI includes:

  • Runs List — all stored runs with status, timing, and detection counts
  • Run Detail — node-by-node trace with inputs, outputs, and detections
  • Compare Runs — side-by-side diff between any two runs
  • Approvals — review and approve AI-discovered failure signatures
  • Report Board — submit diagnostic reports for bugs or issues
  • Settings — configure Linear integration and cloud sync

From the Run Detail page, hover any step and click ↺ Rerun From Here to trigger a replay. After rerun, the diff view opens automatically.

argus doctor

Diagnose setup issues. Checks Python version, LangGraph compatibility, storage health, rerun readiness, and optional dependencies.

bash
argus doctor
text
✓  python           Python 3.9.6
✓  langgraph        langgraph 0.6.11
✓  storage          312 runs stored, all healthy
✓  replay           all 7 node functions importable for rerun
✓  optional deps    openai (key set), dotenv

argus login / logout / whoami

Manage authentication for cloud sync features (shared signatures, team collaboration).

bash
# Sign in for cloud sync
argus login

# Clear credentials
argus logout

# Check login status
argus whoami

argus update

Check for and install ARGUS updates.

bash
# Check for a new release
argus update
Previous

Adaptive Learning

Next

API Reference