CLI Reference

macOS & Linux (install script)

# Beta — install script (not yet published; use clone-and-build below)
# curl -fsSL https://raw.githubusercontent.com/lydianai/AILYDIAN-AGENT-ORCHESTRATOR/main/cli/scripts/install.sh | sh

Clone and build

git clone https://github.com/lydianai/AILYDIAN-AGENT-ORCHESTRATOR.git
cd AILYDIAN-AGENT-ORCHESTRATOR
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python3 server.py

Verify the CLI is available with lydos --version. The local server runs on http://localhost:8888.

# Check current auth state
lydos whoami

# Confirm server is reachable and healthy
lydos status

Config file: ~/.lydos/config.json

{
  "api_url": "http://localhost:8888",
  "default_model": "llama-3.3-70b-versatile",
  "timeout": 30
}

First-time setup

$ lydos doctor
Checking Python environment... ok (3.12.3)
Checking venv (~/.ailydos-venv)... ok
Checking .env... ok (PRIMARY_API_KEY set)
Checking server (http://localhost:8888)... ok

$ lydos status
Server: http://localhost:8888
Health: 94/100 — All systems operational
Modules: 28/29 healthy (1 degraded: analysis_api)
Agents available: 109
MCP tools: 162

Running an agent

$ lydos agent run harika --prompt "Analyze security posture of this repo"
Running agent: harika
Task ID: task_3f8c9d2e1b4a5e7f
Status: running...

[████████████████████] done (12.4s)

Result:
  Found 3 medium-severity issues in ./src/api/auth.ts
  Recommendation: Rotate JWT secret, add rate limiting to /login
  Full report: ~/.lydos/reports/task_3f8c9d2e1b4a5e7f.json

Auth and config state

$ lydos whoami
API URL:  http://localhost:8888
Model:    llama-3.3-70b-versatile
Timeout:  30s
Config:   ~/.lydos/config.json

$ lydos logs
[2026-03-28 14:22:01] agent run harika — done (8.3s)
[2026-03-28 14:18:44] chat "What is LYDOS?" — done (1.1s)
[2026-03-28 14:15:02] health — score 94/100

lydos chat <message>

Send a single message to LyDos LLM and get a response.

Flags

Examples

# Simple query
lydos chat "Explain quantum computing"

# Stream response
lydos chat --stream "Write a poem about AI"

# Custom model and length
lydos chat --model llama-3.3-70b --max-tokens 1000 "..."

# JSON output
lydos chat --json "What is 2+2?"

lydos agents list

List all available agents with categories and descriptions.

lydos agents list
lydos agents list --json  # Machine-readable
lydos agents list --category security  # Filter by category

lydos agents get <id>

Get detailed information about a specific agent.

lydos agents get security-scanner
lydos agents get deep-research --json

lydos agents run <id> <task>

Run an agent with a specific task.

Flags

Examples

# Run security scanner
lydos agents run security-scanner "Scan ./src for vulnerabilities"

# With parameters
lydos agents run security-scanner \
  "Scan ./src" \
  --param depth=comprehensive \
  --param include_deps=true

# Watch for completion
lydos agents run deep-research "Research AI trends" --watch

# Get task ID only
lydos agents run code-reviewer "Review PR" --json

lydos tasks list

List recent tasks with status and details.

Flags

Examples

lydos tasks list                        # All recent tasks
lydos tasks list --status running       # Only running tasks
lydos tasks list --status completed     # Only completed tasks
lydos tasks list --limit 100 --json     # 100 latest as JSON

lydos tasks get <id>

Get full details for a specific task including results.

lydos tasks get task_3f8c9d2e1b4a5e7f
lydos tasks get task_abc --json

lydos tasks watch

Real-time task monitor with auto-refresh.

lydos tasks watch                  # Monitor all tasks
lydos tasks watch --interval 1     # Refresh every 1 second

lydos tasks cancel <id>

Cancel a running or pending task.

lydos tasks cancel task_3f8c9d2e1b4a5e7f

lydos health

Display system health score and subsystem status.

lydos health        # Human-readable format
lydos health --json # Machine-readable JSON

lydos engines list

List all Q-engines with categories and statistics.

lydos engines list
lydos engines list --json

lydos engines stats <id>

Get detailed statistics for a specific engine.

lydos engines stats q25          # Plugin Engine stats
lydos engines stats q32 --json   # Bug Bounty Engine JSON

lydos login

Open browser OAuth flow. On completion, writes token to ~/.lydos/config.json.

lydos login  # Opens browser, saves token automatically

lydos auth token

Show your current token (masked for security).

lydos auth token  # Shows: lyd_sk_abcd...wxyz

lydos auth logout

Remove the stored token from ~/.lydos/config.json.

lydos auth logout  # Clears stored credentials

lydos doctor

Run system diagnostics — checks Python version, venv, .env file, and server reachability. Useful for troubleshooting a fresh install.

lydos doctor         # Full diagnostics
lydos doctor --json  # Machine-readable output

lydos init

Initialize a new project — creates a .env template and writes a .mcp.json config pointing at the local server.

lydos init           # Interactive setup in current directory
lydos init --force   # Overwrite existing config files

lydos whoami

Show the current auth and config state — API URL, model, timeout, and config file path.

lydos whoami         # Human-readable summary
lydos whoami --json  # Machine-readable JSON

lydos demo

Guided first-run experience — walks through a health check, runs a sample agent, and shows a chat response. Ideal for verifying a fresh setup end-to-end.

lydos demo           # Interactive guided walkthrough

lydos logs

Show recent execution history — agent runs, chat requests, health checks, and task completions with timestamps and durations.

Flags

lydos logs                  # Last 20 entries
lydos logs --limit 50       # Last 50 entries
lydos logs --follow         # Live tail
lydos logs --level error    # Errors only

lydos config set <key> <value>

Set a configuration value.

lydos config set model llama-3.3-70b
lydos config set timeout 60
lydos config set api_url http://localhost:8888

lydos config get <key>

Get a single configuration value.

lydos config get model

lydos config show

Display all current configuration values.

lydos config show

lydos mcp install

Automatically write the correct .mcp.json into your project root for AI IDE integration. Reads your stored token and server URL from ~/.lydos/config.json.

lydos mcp install              # Writes .mcp.json in current directory
lydos mcp install --global     # Writes ~/.mcp.json (all projects)
lydos mcp install --print      # Print config without writing

lydos mcp setup

Print MCP configuration for AI IDEs or other tools.

lydos mcp setup  # Outputs ready-to-paste .mcp.json

lydos version

Display CLI version and build information.

lydos version  # Shows version, build date, etc.

Environment Variables

These override the values in ~/.lydos/config.json without modifying the config file.

# Override API URL (e.g. to a remote VPS deploy)
export LYDOS_API_URL="http://localhost:8888"

# Override request timeout in seconds
export LYDOS_TIMEOUT="60"

Piping & Scripting

# Use --json for scripts
RESULT=$(lydos chat --json "What is X?" | jq -r '.text')

# Pipe long input
cat large_file.txt | lydos chat "Summarize this"

# Batch operations
for file in *.py; do
  lydos agents run code-reviewer "Review $file"
done