Skip to main content

Documentation Index

Fetch the complete documentation index at: https://jacobpevans-docs-automation-surface.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

The whole AI toolkit, in one flake. nix run and go.
nix-ai is the package and config layer for everything AI-coding-related. It packages CLIs that don’t yet have first-party Nix derivations, pins MCP server versions, and exports overlays the rest of the Nix stack consumes.

What it does

  • Packages Claude Code, Gemini CLI, GitHub Copilot CLI, and assorted AI tooling
  • Provides MLX module derivations for Apple Silicon
  • Pins 15+ MCP servers and exposes them as reusable Nix attributes
  • Exports an overlay so nix-darwin and nix-home can include AI tools without duplicating logic
  • Includes a shell module (devShells.default) for “just give me an AI sandbox” workflows

How it fits

Feeds intoConsumes
macOS host overlay, User environment packages, ad-hoc nix shellai-assistant-instructions rule set

Getting started

1

Try a single tool

nix run github:JacobPEvans/nix-ai#claude-code -- --help. No clone needed.
2

Enter the sandbox shell

nix develop github:JacobPEvans/nix-ai drops you into a shell with every AI CLI on PATH.
3

Import into nix-darwin

Add nix-ai as a flake input, then include nix-ai.overlays.default in your nixpkgs config. The README has the boilerplate.

ai-assistant-instructions

The rules layer. nix-ai packages the tools; this configures them.

claude-code-plugins

Extension layer on top of the packaged Claude Code CLI.

nix-darwin

The system-level consumer.

Source on GitHub

Packages, overlays, full README.