Demo Bot (CLI)

TL;DR

DemoBot is a CLI bot for local testing — no external messaging API needed. Install with pip install cmdop-bot (no extras required). Runs directly in your terminal with rich formatting. Supports all standard commands plus chat mode where plain text goes to the AI agent. Token streaming is enabled by default.

CLI bot for local testing. No external messaging API needed — runs directly in your terminal with rich formatting.

How do I install?


# Install the base package — DemoBot uses rich for terminal output (included by default)
pip install cmdop-bot

No channel extras required — DemoBot uses rich for terminal formatting (included by default).

How do I use the DemoBot?


from cmdop_bot.channels.demo import DemoBot
 
# Create a DemoBot pointing at your CMDOP API and target machine
bot = DemoBot(
    cmdop_api_key="cmdop_xxx",  # Your CMDOP API key
    machine="my-server",         # Default target machine hostname
)
 
bot.run()  # Starts the interactive CLI session in your terminal

What parameters are available?

Parameter	Type	Required	Description
`cmdop_api_key`	`str`	Yes	CMDOP API key
`machine`	`str`	No	Default target machine hostname
`model`	`str`	No	AI model tier (use `Model.balanced()` etc.)
`server`	`str`	No	gRPC server address (e.g. `127.0.0.1:50051`)
`insecure`	`bool`	No	Disable TLS (for local dev)
`timeout`	`float`	No	Command timeout in seconds (default: 120.0)
`stream`	`bool`	No	Stream agent tokens in real-time (default: `True`)

What commands are supported?

Command	Description
`/help`	Show available commands
`/agent <task>`	Run AI agent (with streaming)
`/shell <cmd>`	Execute shell command
`/exec <cmd>`	Alias for `/shell`
`/ls [path]`	List directory
`/cat <path>`	Read file
`/machine [name]`	Show or set target machine
`/status`	Show current machine and model
`/quit`	Exit the bot

How does chat mode work?

Any text that doesn’t start with / is sent directly to the AI agent:


> Check disk usage on this server
⏳ Thinking...
Using tool: execute_shell
...

How does streaming work?

When stream=True (default), agent responses stream token-by-token to your terminal. Tool usage events are also shown:


> Analyze the nginx config
Using tool: read_file
Using tool: execute_shell
The nginx configuration shows...

How do I connect to a local agent?

Connect directly to a local agent without cloud relay:


# Point the bot at a local gRPC agent server instead of the cloud
bot = DemoBot(
    cmdop_api_key="cmdop_xxx",
    server="127.0.0.1:50051",  # Local gRPC server address
    insecure=True,              # Disable TLS for local development
)
 
bot.run()  # Starts the CLI session connected to the local agent