nixpi

nixpi declaratively configures the Pi coding agent with Nix. It provides one typed programs.pi module for standalone packages, Home Manager, NixOS, and nix-darwin.

Start here

Run the default agent without creating a configuration:

nix run github:mateusdcc/nixpi

For a project or personal configuration, start from a template, then read the usage guide. The complete option reference is generated from the live Nix module schema during every documentation build, so it includes every programs.pi option, type, default, and description.

What is documented

• Every public flake output and library function, with callable examples.
• Every programs.pi option, generated from the evaluated module.
• Bundled profiles, extensions, skills, and providers.
• Home Manager, NixOS, nix-darwin, standalone, devShell, and direnv usage.
• Templates, secrets, mutable state, updating, tests, migration guidance, and troubleshooting.

The site is built by nix build .#docs. Its static files are in result/share/doc/nixpi/html and GitHub Actions publishes that same directory to GitHub Pages.