Back to Home
mbrock icon

busker

Verified Safe

by 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

Run Command
swash http serve

Environment 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

Stats

Interest Score8
Security Score7
Cost ClassMedium
Avg Tokens5000
Stars1
Forks0
Last Update2025-12-13

Tags

session managementstructured loggingLLM agentsterminal emulationsystemdWASIRDF store