The 16 MCP tools
Two entries are not standalone MCP servers: shesh_files ships as a library and classifier CLI (no console script of its own), and wave/ is desktop terminal widgets and theme config rather than an MCP tool — both are included here because they are part of the same 16 folded packages.
Policy + hash-chained event log; every other tool's calls pass through its Guard. Console script: shesh-audit-mcp
Secrets handling. Console script: shesh-secrets-mcp
The core brain package. Console script: shesh-brain-mcp
Agent Client Protocol. Console script: shesh-acp
Shell access. Console script: shesh-shell-mcp
System-level operations. Console script: shesh-system-mcp
File library + classifier CLI (no MCP console script).
Media handling. Console script: shesh-media-mcp
Messaging integration. Console script: shesh-messaging-mcp
Calendar integration. Console script: shesh-calendar-mcp
Backup operations. Console script: shesh-backup-mcp
Container management. Console script: shesh-containers-mcp
eBPF-based tooling. Console script: shesh-ebpf-mcp
Proxies filesystem/fetch/git MCP servers. Console script: shesh-mcp-bundle-mcp
How the layers connect#
shesh_shell, shesh_system, shesh_media, shesh_messaging, and shesh_mcp_bundle all report into shesh_audit — every Soma-layer action is logged to the same hash-chained audit trail before it executes.
All 16 packages install together from one pyproject.toml, with one lockfile and one lint config.