Table of Contents

Simple and Fast Nix Packages

Nix flake providing packages, devshells, and Docker images for Simple and Fast projects.

1. Packages

Package Attribute Description

Pi .#pi AI coding agent with CLI interface, built-in tools, model registry, and agent sessions.

Autobot .#autobot Email agent – processes incoming emails via JMAP, delegates to pi coding agent, sends replies. Built with Node.js 24, node:sqlite, vite.

Skills .#skills Go-based tools (RSS-to-email, web fetcher) and convention files for AI agents.

Agent Conventions .#agent-conventions Coding standards, git workflow, testing guidelines, and agent behavior rules.

Docbuilder .#docbuilder-site Asciidoctor-based static site generator with stork search.

Stork Search .#storkjs WASM and JavaScript assets for client-side full-text search.

RFD .#rfd Requests for Discussion — numbered proposal documents.

Package	Attribute	Description
Pi	`.#pi`	AI coding agent with CLI interface, built-in tools, model registry, and agent sessions.
Autobot	`.#autobot`	Email agent – processes incoming emails via JMAP, delegates to pi coding agent, sends replies. Built with Node.js 24, node:sqlite, vite.
Skills	`.#skills`	Go-based tools (RSS-to-email, web fetcher) and convention files for AI agents.
Agent Conventions	`.#agent-conventions`	Coding standards, git workflow, testing guidelines, and agent behavior rules.
Docbuilder	`.#docbuilder-site`	Asciidoctor-based static site generator with stork search.
Stork Search	`.#storkjs`	WASM and JavaScript assets for client-side full-text search.
RFD	`.#rfd`	Requests for Discussion — numbered proposal documents.

2. Quick start

2.1. Building a package

nix build .#pi
nix build .#autobot
nix build .#nixpkgs-docs

2.2. Entering a devshell

nix develop

2.3. Building the Docker image

nix build .#dockerImage
docker load < result

3. Adding a package

Create pkgs/<name>/default.nix following existing patterns
Add to flake.nix packages section:

my-package = callPackage ./pkgs/my-package {
  src = inputs.my-package-src;
};

Add to contents list in the Docker image if it should be included

4. Package structure

pkgs/
  pi/                   Pi coding agent
  autobot/              Autobot email agent
  skills/               Pi skills and conventions
  agent-conventions/    Agent conventions
  docbuilder/           Documentation builder
  storkjs/              Stork search assets
  rfd/                  RFD site config
  nixpkgs-docs/         This documentation site

5. Flake inputs

All package sources are fetched via git SSH URLs:

Input Repository

pi-mono Pi monorepo

bot-src Bot repository

skills-src Skills repository

docbuilder-src Docbuilder repository

rfd-src RFD repository