OpenWalrusOpenWalrus

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>
FlagDescriptionDefault
--agent <NAME>Override the agent nameassistant
--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-agent

The REPL streams agent responses in real time. Type a message and press Enter to send.

daemon

Start the OpenWalrus daemon in the foreground:

walrus daemon

The 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 list

model

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

On this page