kissgyorgy/coding-agents

# GitHub Repository: kissgyorgy/coding-agents

**URL:** https://github.com/kissgyorgy/coding-agents
**Author:** kissgyorgy
**Description:** Nix packages, skills, extensions for coding-agents (Claude Code, Gemini CLI, Pi Coding Agent, Codex)
**Homepage:** 
**Language:** TypeScript

## Stats
- Stars: 9
- Forks: 2
- Open Issues: 8
- Commits: 1126
- Created: 2026-02-14T13:32:06Z
- Updated: 2026-06-18T15:12:01Z
- Pushed: 2026-06-18T15:10:40Z

## README
# 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](https://github.com/sigoden/aichat) — All-in-one LLM CLI tool                                           |
| **claude-code**     | [Claude Code](https://github.com/anthropics/claude-code) — Anthropic's CLI coding agent                         |
| **claude-code-ui**  | [Claude Code UI](https://github.com/siteboon/claudecodeui) — Web UI for Claude Code                             |
| **codex**           | [Codex](https://github.com/openai/codex) — OpenAI's CLI coding agent                                            |
| **crush**           | [Crush](https://github.com/charmbracelet/crush) — Charm's glamorous terminal coding agent                       |
| **gemini-cli**      | [Gemini CLI](https://github.com/google-gemini/gemini-cli) — Google's CLI coding agent                           |
| **hermes-agent**    | [Hermes Agent](https://github.com/NousResearch/hermes-agent) — Nous Research's self-improving AI agent          |
| **llmfit**          | [llmfit](https://github.com/AlexsJones/llmfit) — Right-size LLM models to your system hardware                  |
| **llmserve**        | [llmserve](https://github.com/AlexsJones/llmserve) — TUI for serving local LLM models                           |
| **openclaude**      | [OpenClaude](https://github.com/Gitlawb/openclaude) — Coding-agent CLI for cloud and local model providers      |
| **pi-coding-agent** | [Pi](https://github.com/earendil-works/pi) — The minimal coding agent with extensions, skills, and TUI          |
| **vibe-kanban**     | [Vibe Kanban](https://github.com/BloopAI/vibe-kanban) — Kanban-style orchestration surface for AI coding agents |
| **whichllm**        | [whichllm](https://github.com/Andyyyy64/whichllm) — Find the best local LLM that runs on your hardware          |
| **ccusage**         | [ccusage](https://www.npmjs.com/package/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](https://agentskills.io) 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](https://devenv.sh) development environments — Python/uv, services (Postgres, Redis), Django projects, and Nix packages |
| **compone**               | Building Python components with the [compone](https://github.com/kissgyorgy/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:

```bash
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:

```nix
# 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:

```nix
# 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.

```nix
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, `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)