coding-agents

Opinionated Nix packages and Home Manager modules for AI coding agents. All agents and aliases are configured with yolo mode by default. (e.g. --dangerously-skip-permissions)

Packages

Package Description
aichat AIChat — All-in-one LLM CLI tool
claude-code Claude Code — Anthropic's CLI coding agent
claude-code-ui Claude Code UI — Web UI for Claude Code
codex Codex — OpenAI's CLI coding agent
crush Crush — Charm's glamorous terminal coding agent
gemini-cli Gemini CLI — Google's CLI coding agent
hermes-agent Hermes Agent — Nous Research's self-improving AI agent
llmfit llmfit — Right-size LLM models to your system hardware
llmserve llmserve — TUI for serving local LLM models
openclaude OpenClaude — Coding-agent CLI for cloud and local model providers
pi-coding-agent Pi — The minimal coding agent with extensions, skills, and TUI
vibe-kanban Vibe Kanban — Kanban-style orchestration surface for AI coding agents
whichllm whichllm — Find the best local LLM that runs on your hardware
ccusage ccusage — Track Claude Code token usage and costs

Packages are automatically updated every hour via GitHub Actions.

Supported flake systems are x86_64-linux and aarch64-darwin. llmfit, llmserve, playwright-cli, and vibe-kanban are currently Linux-only.

Skills

Agent Skills get installed into each agent's config directory, so every agent has access to the same domain knowledge.

Skill Description
devenv Setting up devenv.sh development environments — Python/uv, services (Postgres, Redis), Django projects, and Nix packages
compone Building Python components with the compone framework for type-safe HTML/XML/RSS generation
hn-sentiment-analysis Manual Hacker News thread sentiment analysis from a provided HN URL, with Algolia download and preparation scripts

Installation

Flake packages (ad-hoc usage)

Run any package directly:

nix run github:kissgyorgy/coding-agents#aichat
nix run github:kissgyorgy/coding-agents#claude-code
nix run github:kissgyorgy/coding-agents#codex
nix run github:kissgyorgy/coding-agents#crush
nix run github:kissgyorgy/coding-agents#gemini-cli
nix run github:kissgyorgy/coding-agents#hermes-agent
nix run github:kissgyorgy/coding-agents#openclaude
nix run github:kissgyorgy/coding-agents#pi-coding-agent
nix run github:kissgyorgy/coding-agents#vibe-kanban
nix run github:kissgyorgy/coding-agents#whichllm

Home Manager module

Add the flake input:

# flake.nix
{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
    home-manager.url = "github:nix-community/home-manager";
    coding-agents.url = "github:kissgyorgy/coding-agents";
  };
}

Import the module and apply the overlay:

# In your Home Manager configuration
{ inputs, ... }:
{
  imports = [ inputs.coding-agents.homeManagerModules.default ];

  nixpkgs.overlays = [ inputs.coding-agents.overlays.default ];

  coding-agents = {
    claude-code.enable = true;
    codex.enable = true;
    crush.enable = true;
    gemini-cli.enable = true;
    hermes-agent.enable = true;
    pi-coding-agent.enable = true;
  };
}

Options

coding-agents.skillsDir

Path to a custom skills directory shared by all agents. Defaults to the built-in skills. This directory will be symlinked to every agent specific skills directory if specified.

coding-agents.skillsDir = ./my-skills;

coding-agents.claude-code

  • enable — Install Claude Code, ccusage, and configure shell aliases (claude, claude-api)
  • claudeMdPath — Path to a custom CLAUDE.md file (defaults to the built-in one)

Claude Code is configured with pre-approved tool permissions, a command validator hook, an auto-formatter hook on file writes, and 1Password API key integration.

coding-agents.codex

  • enable — Install Codex and link shared skills

coding-agents.crush

  • enable — Install Crush, link shared skills, configure crush.json with allowed tool permissions, LSPs (gopls, typescript-language-server, nil, pyright), disabled attribution, and add a crush shell alias (runs with -y yolo mode)

coding-agents.gemini-cli

  • enable — Install Gemini CLI and add a gemini shell alias (runs with --yolo --model pro)

coding-agents.hermes-agent

  • enable — Install Hermes Agent

coding-agents.pi-coding-agent

  • enable — Install Pi, ImageMagick, nil, basedpyright, typescript-language-server, typescript, gopls, go, and link shared skills and extensions
  • extensionsDir — Path to a custom extensions directory (defaults to built-in extensions including tmux-mirror, plan-mode, and more)