CLI Reference
All OpenWalrus CLI commands and flags — attach, daemon, hub, and model management.
The walrus binary provides commands for interacting with the OpenWalrus daemon.
Global flags
walrus [FLAGS] <COMMAND>| Flag | Description | Default |
|---|---|---|
--agent <NAME> | Override the agent name | assistant |
--socket <PATH> | Override the socket path | ~/.openwalrus/walrus.sock |
Commands
attach
Connect to a running daemon and start an interactive REPL:
walrus attach
walrus attach --agent my-agentThe REPL streams agent responses in real time. Type a message and press Enter to send.
daemon
Start the OpenWalrus daemon in the foreground:
walrus daemonThe daemon:
- Loads configuration from
~/.openwalrus/walrus.toml - Starts the event loop
- Opens a Unix socket at
~/.openwalrus/walrus.sock - Connects configured channels (Telegram, Discord)
- Connects configured MCP servers
hub
Manage hub packages (skills and extensions):
walrus hub install <package>
walrus hub uninstall <package>
walrus hub listmodel
Manage local LLM models:
walrus model list
walrus model download <model-id>Downloads models from HuggingFace Hub. Requires the local feature flag. See local inference for details.
What's next
- Configuration — walrus.toml setup
- Full config reference — every configuration field