-
Notifications
You must be signed in to change notification settings - Fork 68
CLI Reference
dEXploarer edited this page Mar 27, 2026
·
2 revisions
All commands are run via the milady binary. Multiple aliases are registered: milady, milady.ai, milady-ai, miladyai, milaidy.
| Command | Description |
|---|---|
milady |
Start the agent runtime with TUI (default) |
milady start |
Server-only mode (API server, no interactive TUI) |
milady start --headless |
Start without opening a browser popup |
milady --verbose |
Enable informational runtime logs |
milady --debug |
Enable debug-level runtime logs |
MILADY_GATEWAY_PORT=19000 MILADY_PORT=3000 milady start
| Command | Description |
|---|---|
milady setup |
First-time setup or workspace refresh after update |
milady configure |
Interactive config wizard |
milady config get <key> |
Read a single config value |
milady config set <key> <value> |
Write a single config value |
| Command | Description |
|---|---|
milady dashboard |
Open the web UI in your browser |
milady dashboard --port 3000 |
Open on a custom port |
| Command | Description |
|---|---|
milady models |
List configured model providers |
milady models add |
Add a new provider interactively |
milady models test |
Test whether your API keys are working |
| Command | Description |
|---|---|
milady plugins list |
Browse registry plugins |
milady plugins installed |
List what's installed |
milady plugins install <name> |
Install a plugin |
milady plugins uninstall <name> |
Remove a plugin |
milady plugins search <query> |
Search by keyword |
| Command | Description |
|---|---|
milady doctor |
Diagnose common issues |
milady --version |
Print the installed version |
milady --help |
Show help text |
| Service | Default | Env Override |
|---|---|---|
| API + WebSocket | 31337 | MILADY_API_PORT |
| Gateway (API + WebSocket) | 18789 | MILADY_GATEWAY_PORT |
| Dashboard (Web UI) | 2138 | MILADY_PORT |
| Home Dashboard | 2142 | MILADY_HOME_PORT |
The TUI launches automatically when you run milady. Use milady start for server-only mode without the TUI.
| Key | Action |
|---|---|
q |
Quit gracefully |
r |
Restart gateway |
d |
Open dashboard in browser |
l |
Toggle log view |
c |
Compact/clear activity |
? |
Show help |
↑/↓
|
Scroll activity |
These commands are typed in the chat interface and work across all connectors (web, Telegram, Discord, etc.):
| Command | Description |
|---|---|
/status |
Show session status, token count, and cost |
/new or /reset
|
Clear memory and start a fresh session |
/compact |
Compress context (the agent summarizes the conversation) |
/think <level> |
Set reasoning level: off, minimal, low, medium, high, max
|
/verbose on|off |
Toggle verbose responses |
/usage off|tokens|full |
Per-message token display |
/model <id> |
Switch model mid-session |
/restart |
Restart the gateway |
/help |
List available commands |
Run without the TUI:
milady start
Or explicitly suppress the browser popup:
milady start --headless
Logs go to ~/.milady/logs/. Use your preferred process manager (systemd, pm2, launchd, etc.) to daemonize.
The CLI supports named profiles set via --profile <name> or the MILADY_PROFILE env var. Profiles apply predefined env overrides. The built-in dev profile sets development defaults.
MILADY_PROFILE=dev milady start