busker
Verified Safeby mbrock
Overview
Persistent, observable, and re-attachable process sessions for CLI commands, primarily intended as infrastructure for LLM coding agents and general task management. It provides structured output logging and integrates with RDF knowledge graphs.
Installation
swash http serveEnvironment Variables
- SWASH_BACKEND
- SWASH_ROOT_SLICE
- SWASH_STATE_DIR
- SWASH_RUNTIME_DIR
- SWASH_DEBUG
- SWASH_CONTEXT
- XDG_STATE_HOME
- XDG_RUNTIME_DIR
- DBUS_SESSION_BUS_ADDRESS
- JOURNAL_STREAM
Security Notes
The project's core functionality involves executing arbitrary commands (`swash run`), which is inherently high-risk, requiring careful input sanitization and execution context control. While WASM components (oxigraph, libvterm) provide sandboxing for those specific libraries, the main Go application itself is not sandboxed. The `systemd` backend leverages robust process management, but relies on correct configuration and the integrity of systemd itself. The custom Go implementation of the journal file format (`pkg/journalfile`), involving low-level binary I/O and hash table management, is complex and could be a source of subtle bugs. The HTTP API (`swash http serve`) and RDF graph service (`swash graph serve`) are potential network attack surfaces if exposed publicly, allowing for unauthorized command execution, SPARQL injection, or resource exhaustion. It is critical to ensure these services are bound to localhost or Unix sockets and secured appropriately for local access only.
Similar Servers
tmux-mcp
Enables AI assistants (like Claude Desktop) to interact with, control, and observe tmux terminal sessions by providing tools for session management and command execution.
claude-command-runner
Facilitates AI-driven command execution and terminal automation by bridging Claude Desktop with local macOS terminals, primarily Warp, enabling intelligent output capture, command pipelines, real-time streaming, and reusable templates for developers.
systemd-mcp
Manages systemd services, units, and logs via the Model Context Protocol (MCP) by directly connecting to systemd's C API.
dotprompts
A personal prompt management system exposed as a Model Context Protocol (MCP) server, enabling AI agents to access, create, update, and delete user-defined prompts.