CLI Reference

All CrabTalk CLI commands — attach, daemon, hub, task, and session management.

The crabtalk binary provides commands for interacting with the CrabTalk daemon.

Global flags

crabtalk [FLAGS] <COMMAND>

Flag	Description	Default
`--agent <NAME>`	Override the agent name	`crabtalk`
`--socket <PATH>`	Override the socket path	`~/.crabtalk/crabtalk.sock`
`--tcp`	Connect via TCP instead of Unix socket	—

Commands

attach

Connect to a running daemon and start an interactive REPL:

crabtalk attach
crabtalk attach --agent my-agent
crabtalk attach --tcp

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

daemon

Start the CrabTalk daemon in the foreground:

crabtalk daemon

The daemon:

Loads configuration from ~/.crabtalk/crabtalk.toml
Starts the event loop
Opens a Unix socket at ~/.crabtalk/crabtalk.sock
Opens a TCP listener (port written to ~/.crabtalk/crabtalk.tcp)
Spawns configured extensions (search, gateway)
Connects configured MCP servers

hub

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

crabtalk hub install <package>
crabtalk hub uninstall <package>
crabtalk hub list

task

Manage active tasks:

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

session

Manage active conversation sessions:

crabtalk session list
crabtalk 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 — crabtalk.toml setup
Full config reference — every configuration field
Sessions — session lifecycle and management

CLI Reference

On this page