nix-agentic-tools

Stacked commit workflows, MCP servers, and declarative configuration for AI coding CLIs (Claude Code, Copilot, Kiro). Works without Nix; Nix unlocks overlays, home-manager modules, and devshell integration.

Quick Start

<details> <summary><strong>Non-Nix (copy skills into your project)</strong></summary>

Prerequisites: git-branchless, git-absorb, git-revise.

# Claude Code
cp -r packages/stacked-workflows/skills/stack-* .claude/skills/

# Kiro
cp -r packages/stacked-workflows/skills/stack-* .kiro/skills/

# GitHub Copilot
cp -r packages/stacked-workflows/skills/stack-* .github/skills/

Each skill is self-contained with a SKILL.md and bundled reference docs.

</details> <details> <summary><strong>Home-Manager (system-level declarative config)</strong></summary>

# flake.nix
inputs.nix-agentic-tools = {
  url = "github:higherorderfunctor/nix-agentic-tools";
  inputs.nixpkgs.follows = "nixpkgs";
};

# Apply overlay
nixpkgs.overlays = [inputs.nix-agentic-tools.overlays.default];

# Home-manager config
imports = [inputs.nix-agentic-tools.homeManagerModules.default];

ai = {
  claude.enable = true;
  copilot.enable = true;
  kiro.enable = true;
};

stacked-workflows = {
  enable = true;
  gitPreset = "full";
  integrations.claude.enable = true;
};

services.mcp-servers.servers.github-mcp = {
  enable = true;
  settings.credentials.file = "/run/secrets/github-token";
};

Note (Kiro steering uninstall): Kiro steering files are materialized as read-only real files (the Kiro v3 engine ignores symlinks — kirodotdev/Kiro#9787). Disabling ai.kiro removes the materializer itself, so already-written steering files are NOT pruned. To uninstall cleanly, first empty the steering surface (or set ai.kiro.steeringStrategy = "symlink") for one activation, then disable.

</details> <details open> <summary><strong>DevEnv (per-project dev shell)</strong></summary>

# devenv.yaml
inputs:
  nix-agentic-tools:
    url: github:higherorderfunctor/nix-agentic-tools
    inputs:
      nixpkgs:
        follows: nixpkgs

# devenv.nix
{inputs, ...}: {
  imports = [inputs.nix-agentic-tools.devenvModules.nix-agentic-tools];

  ai.claude.enable = true;

  claude.code = {
    mcpServers.github-mcp = {
      type = "stdio";
      command = "github-mcp-server";
      args = ["--stdio"];
    };
  };
}

</details>

Skills

Stacked commit workflow skills using git-branchless, git-absorb, and git-revise.

<!-- prettier-ignore -->

Skill	Description
/stack-fix	Absorb fixes into correct stack commits
/stack-plan	Plan and build a commit stack from description or existing commits
/stack-split	Split a large commit into reviewable atomic commits
/stack-submit	Sync, validate, push stack, and create stacked PRs
/stack-summary	Analyze stack quality, flag violations, produce planner-ready summary
/stack-test	Run tests or formatters across every commit in a stack

Packages

<details> <summary><strong>MCP Servers</strong> (16 servers)</summary> <!-- prettier-ignore -->

Server	Description	Credentials
aihubmix-mcp	AIHubMix image and video generation	Required
context7-mcp	Library documentation lookup	None
effect-mcp	Effect-TS documentation	None
fetch-mcp	HTTP fetch + HTML-to-markdown	None
git-intel-mcp	Git repository analytics	None
git-mcp	Git operations	None
github-mcp	GitHub platform integration	Required
gitlab-mcp	GitLab platform integration	Required
kagi-mcp	Kagi search and summarization	Required
mcp-language-server	LSP-to-MCP bridge	None
mcp-proxy	stdio-to-HTTP bridge proxy	None
nixos-mcp	NixOS and Nix documentation	N