CLI & Tools Reference

wallhack-mcp

wallhack-mcp is an MCP (Model Context Protocol) server that exposes all daemon management operations as tools for AI assistants such as Claude Desktop. It connects to a running wallhackd daemon and makes operations like checking status, managing peers, adding routes, and shutting down available as structured tool calls.

By default, wallhack-mcp connects to the local daemon Unix socket. To connect to a daemon running in a VM or on a remote host, set WALLHACK_HOST to a vsock address:

WALLHACK_HOST=vsock://3:4434 wallhack-mcp

wallhack REPL

Every entry node includes an interactive command-line interface for direct access to the node state. The REPL is automatically disabled when stdin is not a terminal (e.g., in Docker or when running as a daemon).

Commands

CommandAliasesDescription
info-Show daemon info
version-Show version
stats-Show traffic statistics
peers-List connected peers
route add <cidr> [via] <peer>-Add a route
route del <cidr>-Remove a route
route listrouteList configured routes
connect <addr>-Connect to a peer
listen <addr>-Start listening for connections
disconnect [peer]-Disconnect peer
shutdown-Shut down the daemon
help?Show this help
quitexitQuit the REPL

Example Session

wallhack> peers
NAME   ADDR             STATUS     LATENCY  TUN  LISTEN  CONNECT
peer1  10.0.1.5:52341   connected  1.2ms    no   no      yes

wallhack> route add 10.0.0.0/8 via peer1
OK

wallhack> route list
CIDR        PEER
10.0.0.0/8  peer1