CLI Reference
Global Flags
| Flag | Description |
|---|---|
--version |
Show version |
--help |
Show help |
--config <path> |
Use alternate config file |
--verbose |
Enable debug output |
Commands
openalloy activate
Activate your license key.
openalloy activate --key OA-XXXX-XXXX-XXXX| Flag | Description |
|---|---|
--key <key> |
License key to activate |
openalloy chat
Start interactive TUI chat.
openalloy chat [--provider <name>] [--model <model>]| Flag | Default | Description |
|---|---|---|
--provider |
Config default | LLM provider |
--model |
Config default | Model name |
--system <prompt> |
None | System prompt |
--history <n> |
50 | Max history messages |
openalloy agent
Run in non-interactive agent mode.
echo "input" | openalloy agent [flags]
openalloy agent -f <file> [flags]| Flag | Default | Description |
|---|---|---|
--provider |
Config default | LLM provider |
--model |
Config default | Model name |
-f, --file <path> |
stdin | Input file |
--system <prompt> |
None | System prompt |
--json |
false | Output as JSON |
--max-tokens <n> |
4096 | Max output tokens |
openalloy daemon
Run a background daemon.
openalloy daemon --whatsapp| Flag | Description |
|---|---|
--whatsapp |
Start WhatsApp bridge |
--install-service |
Install as system service |
--uninstall-service |
Remove system service |
openalloy config
Manage configuration.
openalloy config set <key> <value>
openalloy config get <key>
openalloy config list
openalloy config resetopenalloy models
List available models.
openalloy models [--provider <name>]openalloy version
Show version and license info.
openalloy versionExit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Invalid arguments |
| 3 | License validation failed |
| 4 | Provider error (API key, rate limit) |
| 5 | Network error |