◆Command-Line Interface

LyDos CLI — Everything from your terminal

Name: LyDos Agent OS
Author: LYDOS

Chat, run agents, monitor tasks, and manage the full LyDos platform without leaving your shell.

Install CLI Browse Commands

◆Live Demo

See it in action

Click the buttons to simulate real CLI commands. No installation needed.

lydos — terminal

LyDos CLI — Click a command to run it

Click to run:

◆Installation

Install LyDos CLI

Choose your preferred installation method. All methods install the same binary.

install.sh
Bash
# Local install (PyPI package coming soon)
cd web/sdk && pip install -e .
# (Local install — PyPI package coming soon)
 
# Or install all dependencies from source:
git clone https://github.com/lydianai/AILYDIAN-AGENT-ORCHESTRATOR.git
cd AILYDIAN-AGENT-ORCHESTRATOR && pip install -r requirements.txt

After installation, authenticate with lydos auth login and paste your API key. Get your key at your settings page.

◆Command Reference

All commands

Search and filter the full command list. Use lydos <command> --help for detailed flags.

Command	Description	Example
`lydos auth login`	Authenticate with your API key	`lydos auth login`
`lydos auth token`	Display stored API key (masked)	`lydos auth token`
`lydos auth logout`	Remove stored credentials	`lydos auth logout`
`lydos health`	Display system health and subsystem status	`lydos health --json`
`lydos version`	Show CLI version and build info	`lydos version`
`lydos chat <msg>`	Chat with the LyDos LLM	`lydos chat "Explain async/await"`
`lydos chat --stream`	Stream response in real-time	`lydos chat --stream "Write a poem"`
`lydos agents list`	List all available agents	`lydos agents list --category security`
`lydos agents get <id>`	Show agent details and parameters	`lydos agents get security-scanner`
`lydos agents run <id>`	Execute an agent with a task	`lydos agents run deep-research "AI trends"`
`lydos tasks list`	List recent tasks	`lydos tasks list --status running`
`lydos tasks get <id>`	Get task details and results	`lydos tasks get task_abc123`
`lydos tasks watch`	Real-time task monitor	`lydos tasks watch --interval 1`
`lydos tasks cancel <id>`	Cancel a running task	`lydos tasks cancel task_abc123`
`lydos mcp serve`	Start MCP server for AI IDEs	`lydos mcp serve`
`lydos mcp setup`	Print ready-to-paste .mcp.json config	`lydos mcp setup`
`lydos logs`	View recent logs	`lydos logs --follow --level error`
`lydos engines list`	List all Q-engines	`lydos engines list --json`
`lydos config set`	Set a configuration value	`lydos config set timeout 60`
`lydos config show`	Display all configuration values	`lydos config show`

20 of 20 commands

◆Shell Completion

Tab completion

Enable shell completion for Tab-key command and flag suggestions.

completion.sh
Bash
# Bash — add to ~/.bashrc
lydos completion bash >> ~/.bashrc && source ~/.bashrc
 
# Zsh — add to ~/.zshrc
lydos completion zsh >> ~/.zshrc && source ~/.zshrc
 
# Fish
lydos completion fish > ~/.config/fish/completions/lydos.fish
 
# PowerShell
lydos completion powershell >> $PROFILE

◆Automation

Scripting & CI/CD

The CLI is designed for automation. Use --json for machine-readable output and pipe it through jq in your scripts.

JSON output

Add --json to any command for clean, parseable output.

lydos health --json | jq '.score'

Pipe support

Pipe stdin into the chat command for long content.

cat file.py | lydos chat "Review this"

Exit codes

0 on success, 1 on error, 2 on partial failure.

lydos health && echo 'OK'

Example: Automated security scan

scan.sh
Bash
1#!/usr/bin/env bash
2# Example: scan all Python files for security issues
3set -euo pipefail
4 
5echo "Starting security scan..."
6 
7for file in $(find ./src -name "*.py" -type f); do
8  RESULT=$(lydos agents run security-scanner "Scan $file" --json)
9  ISSUES=$(echo "$RESULT" | jq -r '.result.vulnerabilities_found // 0')
10 
11  if [ "$ISSUES" -gt 0 ]; then
12    echo "  WARN: $ISSUES issue(s) in $file"
13    echo "$RESULT" | jq -r '.result.issues[]'
14  fi
15done
16 
17echo "Scan complete."

◆Configuration

Environment variables

Set these in your shell profile to avoid passing flags on every command.

.bashrc
Bash
# Add to ~/.bashrc, ~/.zshrc, or .env
export LYDOS_API_KEY="lyd_sk_your_key_here"
export LYDOS_API_URL="https://lydos.ailydian.com"
export LYDOS_TIMEOUT="60"
export LYDOS_MODEL="llama-3.3-70b-versatile"
 
# Local development (point to self-hosted)
export LYDOS_API_URL="https://lydos.ailydian.com"

Global flags

Flag	Description	Environment override
`--api-key`	Override stored API key	`LYDOS_API_KEY`
`--api-url`	Override API server URL	`LYDOS_API_URL`
`--timeout`	Request timeout (seconds)	`LYDOS_TIMEOUT`
`--json`	JSON output mode	`—`
`--debug`	Enable debug logging	`LYDOS_DEBUG=1`
`--model`	LLM model to use	`LYDOS_MODEL`

◆Interactive TUI

Full terminal UI

Run lydos with no arguments to open the interactive TUI with chat, agents, and tasks in a unified view.

Key	Action
`Enter`	Send message / Confirm
`Ctrl+A`	Focus agents panel
`Ctrl+T`	Focus tasks panel
`Ctrl+L`	Clear chat history
`Ctrl+P`	Open command palette
`Tab / Shift+Tab`	Cycle focus
`Page Up / Page Down`	Scroll panels
`Esc`	Cancel / Close dialog
`q`	Quit TUI

Ready to automate everything?

Install the CLI, connect your API key, and start running agents from your terminal in under 2 minutes.

Install Now MCP Setup →

1	#!/usr/bin/env bash
2	# Example: scan all Python files for security issues
3	set -euo pipefail
4
5	echo "Starting security scan..."
6
7	for file in $(find ./src -name "*.py" -type f); do
8	RESULT=$(lydos agents run security-scanner "Scan $file" --json)
9	ISSUES=$(echo "$RESULT" \| jq -r '.result.vulnerabilities_found // 0')
10
11	if [ "$ISSUES" -gt 0 ]; then
12	echo " WARN: $ISSUES issue(s) in $file"
13	echo "$RESULT" \| jq -r '.result.issues[]'
14	fi
15	done
16
17	echo "Scan complete."