Katsuobushi
Libraries, templates, and agent skills for Nix Flake-based projects, including VM-sandboxed workspaces.
At a Glance
About Katsuobushi
Katsuobushi is a repository by cdata that collects libraries, flake templates, and agent skills the author reuses across Nix Flake-based projects. It covers Rust packaging, Markdown formatting, VM-sandboxed workspaces, a file-backed project board, and a devshell command menu.
What It Is
Katsuobushi is a toolkit for projects built on Nix flakes. Its libraries can be used a la carte, and several flake templates scaffold new projects. The sandbox library, which this page's seed path points to, provides ephemeral, project-specific, VM-sandboxed workspaces. It is Linux-only and built on qemu.
Libraries and Templates
- rust: a convenience wrapper over Crane that reduces boilerplate in Rust project derivations.
- markdown: formatting and linting for Markdown documentation via Prettier.
- sandbox: ephemeral VM-sandboxed workspaces.
- project: a file-backed backlog board (Obsidian Kanban) with sandboxed agent dispatch.
- menu: provided through the flake overlay as pkgs.katsuobushi, it generates a command menu for a project's devshell.
Three templates are available through nix flake init: default (a basic flake with a menu), sandbox (a menu plus a pre-configured sandbox), and rust.
Agent Skills
The repository ships skills that help coding agents use these libraries with minimal extra instructions. They cover sandbox configuration, backlog management, board orchestration with sandboxed agents, authoring a Project Design Document, turning a design into board cards, and driving a swarm of sandboxes to build a label thread. The skills install as a plugin via a plugin marketplace in an agent harness. The design skill can load the third-party grilling, simple-english, and humanizer skills when installed, and otherwise falls back to short inline versions.
Community Discussions
Be the first to start a conversation about Katsuobushi
Share your experience with Katsuobushi, ask questions, or help others learn from your insights.
Pricing
Licensing Unpublished
Katsuobushi is available in a public GitHub repository. The maintainer hasn’t published a software price or license. Any charges from a connected AI provider are separate.
- Nix flake libraries and templates
- Local VM sandbox for agent workspaces
Capabilities
Key Features
- VM-sandboxed ephemeral workspaces via qemu (Linux-only)
- Rust project derivation wrapper over Crane
- Markdown formatting and lint via Prettier
- File-backed Obsidian Kanban project board with sandboxed agent dispatch
- Devshell command menu via overlay
- Flake templates: default, sandbox, rust
- Agent skills for sandbox, project, orchestration, design, plan, implement
- Plugin marketplace installation for agent harnesses
