Operate Mesh

Check status, restart Mesh, and manage connected tools.

Check status

Run smesh status to see Mesh, your policy, and your connected AI tools. Run smesh client protection-state to see which tools have recent traffic through Mesh.

Restart

1. Run smesh doctor to check your installation.
2. Run smesh restart, then smesh status.
3. If you changed a tool’s connection, quit and reopen that tool.

Manage connected tools

• smesh client list shows each tool and how it is connected.
• smesh client connect claude --apply or smesh client connect codex --apply connects a tool.
• smesh client disconnect <name> restores its previous settings. Mesh won’t silently replace a setting that another tool owns. smesh client disconnect restores only a Mesh-owned route; review any conflict it reports.
• smesh client test <name> sends a local test request, not a live provider call.
• smesh client pause and smesh client resume take Mesh offline for maintenance and reconnect the same tools afterward.

Update

To update, re-run the install command, then check smesh status and smesh client list.

Audit and logs

smesh events summary summarizes recent decisions from the local audit record, which never contains message content. smesh logs shows Mesh’s own logs. Don’t paste credentials, prompts or private files into a support request.

Uninstall

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