CLI Reference

The walrus binary provides commands for interacting with the OpenWalrus daemon.

Global flags

walrus [FLAGS] <COMMAND>

Commands

attach

Connect to a running daemon and start an interactive REPL:

walrus attach
walrus attach --agent my-agent
walrus attach --tcp

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
• Opens a TCP listener (port written to ~/.openwalrus/walrus.tcp)
• Spawns configured extensions (search, gateway)
• Connects configured MCP servers

hub

Manage hub packages (skills, extensions, and agents):

walrus hub install <package>
walrus hub uninstall <package>
walrus hub list

task

Manage active tasks:

walrus task list                     # List active tasks
walrus task kill <id>                # Cancel a task
walrus task approve <id> <response>  # Unblock a task with a response

session

Manage active conversation sessions:

walrus session list
walrus session kill <id>

list shows all active sessions with their ID, agent, creator, message count, and age. kill closes a session and frees its history.

What's next

• Configuration — walrus.toml setup
• Full config reference — every configuration field
• Sessions — session lifecycle and management