smesh CLI

Common commands for setup, health checks, and clients.

smesh is the command-line tool for Mesh. Run smesh --help or smesh <command> --help for every option.

Setup and health

Command	Purpose
`smesh init`	Guided first-run setup.
`smesh start`	Start Mesh.
`smesh stop`	Stop Mesh. Your settings are kept.
`smesh restart`	Restart Mesh.
`smesh status`	Show Mesh, policy, and client status.
`smesh doctor`	Check your installation.
`smesh version`	Show the installed version.

Command	Purpose
`smesh client list`	Show your AI tools and how each one is connected.
`smesh client connect <name> --plan`	Preview the settings change for `claude` or `codex`.
`smesh client connect <name> --apply`	Connect `claude` or `codex` to Mesh.
`smesh client protection-state`	Show which connected tools have recent traffic through Mesh.
`smesh client disconnect <name>`	Restore the tool’s previous settings.
`smesh client pause` / `resume`	Pause Mesh for maintenance, then reconnect the same tools.

After connecting, quit and reopen the tool so it picks up the new settings.

Command	Purpose
`smesh dashboard open`	Open the local browser dashboard with a one-time access handoff.
`smesh dashboard status`	Show the dashboard address and the gateway, policy, client and audit state it reports.

The dashboard is included with the script-installed CLI. See the dashboard guide for its panels and privacy boundaries.

Command	Purpose
`smesh policy show`	Show the active policy.
`smesh policy use balanced`	Use the Balanced policy (the default).
`smesh policy use strict`	Use the Strict policy.
`smesh events summary`	Summarize recent decisions from the local audit record.
`smesh logs`	Show Mesh’s own logs.

Run smesh uninstall. It restores your tools’ previous settings. Your settings and local data are kept unless you add --purge-user-data.