numtide/llm-agents.nix

Nix packages for AI coding agents and development tools. Automatically updated daily.

Source code at GitHub https://github.com/numtide/llm-agents.nix

{
  "createdAt": "2025-07-18T10:29:06Z",
  "defaultBranch": "main",
  "description": "Nix packages for AI coding agents and development tools. Automatically updated daily.",
  "fullName": "numtide/llm-agents.nix",
  "homepage": "",
  "language": "Nix",
  "name": "llm-agents.nix",
  "pushedAt": "2026-03-20T20:33:38Z",
  "stargazersCount": 835,
  "topics": [
    "buildbot-numtide"
  ],
  "updatedAt": "2026-03-21T00:37:13Z",
  "url": "https://github.com/numtide/llm-agents.nix"
}

Nix packages for AI coding agents and development tools. Automatically updated daily.

Available Tools

AI Coding Agents

amp - CLI for Amp, an agentic coding tool in research preview from Sourcegraph

Source: bytecode
License: unfree
Homepage: https://ampcode.com/
Usage: nix run github:numtide/llm-agents.nix#amp -- --help
Nix: [packages/amp/package.nix]!(packages/amp/package.nix)

claude-code - Agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster

Source: binary
License: unfree
Homepage: https://claude.ai/code
Usage: nix run github:numtide/llm-agents.nix#claude-code -- --help
Nix: [packages/claude-code/package.nix]!(packages/claude-code/package.nix)
Documentation: See [packages/claude-code/README.md]!(packages/claude-code/README.md) for detailed usage

cli-proxy-api - Unified proxy providing OpenAI/Gemini/Claude/Codex compatible APIs for AI coding CLI tools

Source: source
License: MIT
Homepage: https://github.com/router-for-me/CLIProxyAPI
Usage: nix run github:numtide/llm-agents.nix#cli-proxy-api -- --help
Nix: [packages/cli-proxy-api/package.nix]!(packages/cli-proxy-api/package.nix)

code - Fork of codex. Orchestrate agents from OpenAI, Claude, Gemini or any provider.

Source: source
License: Apache-2.0
Homepage: https://github.com/just-every/code/
Usage: nix run github:numtide/llm-agents.nix#code -- --help
Nix: [packages/code/package.nix]!(packages/code/package.nix)

codex - OpenAI Codex CLI - a coding agent that runs locally on your computer

Source: source
License: Apache-2.0
Homepage: https://github.com/openai/codex
Usage: nix run github:numtide/llm-agents.nix#codex -- --help
Nix: [packages/codex/package.nix]!(packages/codex/package.nix)

copilot-cli - GitHub Copilot CLI brings the power of Copilot coding agent directly to your terminal.

Source: bytecode
License: unfree
Homepage: https://github.com/github/copilot-cli
Usage: nix run github:numtide/llm-agents.nix#copilot-cli -- --help
Nix: [packages/copilot-cli/package.nix]!(packages/copilot-cli/package.nix)

crush - The glamourous AI coding agent for your favourite terminal

Source: source
License: MIT
Homepage: https://github.com/charmbracelet/crush
Usage: nix run github:numtide/llm-agents.nix#crush -- --help
Nix: [packages/crush/package.nix]!(packages/crush/package.nix)

cursor-agent - Cursor Agent - CLI tool for Cursor AI code editor

Source: binary
License: unfree
Homepage: https://cursor.com/
Usage: nix run github:numtide/llm-agents.nix#cursor-agent -- --help
Nix: [packages/cursor-agent/package.nix]!(packages/cursor-agent/package.nix)

droid - Factory AI's Droid - AI-powered development agent for your terminal

Source: binary
License: unfree
Homepage: https://factory.ai
Usage: nix run github:numtide/llm-agents.nix#droid -- --help
Nix: [packages/droid/package.nix]!(packages/droid/package.nix)

eca - Editor Code Assistant (ECA) - AI pair programming capabilities agnostic of editor

Source: binary
License: Apache-2.0
Homepage: https://github.com/editor-code-assistant/eca
Usage: nix run github:numtide/llm-agents.nix#eca -- --help
Nix: [packages/eca/package.nix]!(packages/eca/package.nix)

forge - AI-Enhanced Terminal Development Environment - A comprehensive coding agent that integrates AI capabilities with your development environment

Source: binary
License: MIT
Homepage: https://github.com/antinomyhq/forge
Usage: nix run github:numtide/llm-agents.nix#forge -- --help
Nix: [packages/forge/package.nix]!(packages/forge/package.nix)
Documentation: See [packages/forge/README.md]!(packages/forge/README.md) for detailed usage

gemini-cli - AI agent that brings the power of Gemini directly into your terminal

Source: source
License: Apache-2.0
Homepage: https://github.com/google-gemini/gemini-cli
Usage: nix run github:numtide/llm-agents.nix#gemini-cli -- --help
Nix: [packages/gemini-cli/package.nix]!(packages/gemini-cli/package.nix)

goose-cli - CLI for Goose - a local, extensible, open source AI agent that automates engineering tasks

Source: source
License: Apache-2.0
Homepage: https://github.com/block/goose
Usage: nix run github:numtide/llm-agents.nix#goose-cli -- --help
Nix: [packages/goose-cli/package.nix]!(packages/goose-cli/package.nix)

iflow-cli - AI coding agent for the terminal with free model access via the iFlow platform

Source: bytecode
License: Apache-2.0
Homepage: https://github.com/iflow-ai/iflow-cli
Usage: nix run github:numtide/llm-agents.nix#iflow-cli -- --help
Nix: [packages/iflow-cli/package.nix]!(packages/iflow-cli/package.nix)

jules - Jules, the asynchronous coding agent from Google, in the terminal

Source: binary
License: unfree
Homepage: https://jules.google
Usage: nix run github:numtide/llm-agents.nix#jules -- --help
Nix: [packages/jules/package.nix]!(packages/jules/package.nix)

kilocode-cli - The open-source AI coding agent. Now available in your terminal.

Source: binary
License: Apache-2.0
Homepage: https://kilocode.ai/cli
Usage: nix run github:numtide/llm-agents.nix#kilocode-cli -- --help
Nix: [packages/kilocode-cli/package.nix]!(packages/kilocode-cli/package.nix)

letta-code - Memory-first coding agent that learns and evolves across sessions

Source: bytecode
License: Apache-2.0
Homepage: https://github.com/letta-ai/letta-code
Usage: nix run github:numtide/llm-agents.nix#letta-code -- --help
Nix: [packages/letta-code/package.nix]!(packages/letta-code/package.nix)

mistral-vibe - Minimal CLI coding agent by Mistral AI - open-source command-line coding assistant powered by Devstral

Source: source
License: Apache-2.0
Homepage: https://github.com/mistralai/mistral-vibe
Usage: nix run github:numtide/llm-agents.nix#mistral-vibe -- --help
Nix: [packages/mistral-vibe/package.nix]!(packages/mistral-vibe/package.nix)

nanocoder - A beautiful local-first coding agent running in your terminal - built by the community for the community ⚒

Source: source
License: MIT
Homepage: https://github.com/Mote-Software/nanocoder
Usage: nix run github:numtide/llm-agents.nix#nanocoder -- --help
Nix: [packages/nanocoder/package.nix]!(packages/nanocoder/package.nix)

oh-my-opencode - The Best AI Agent Harness - Multi-Model Orchestration for OpenCode

Source: source
License: unfree
Homepage: https://github.com/code-yeongyu/oh-my-openagent
Usage: nix run github:numtide/llm-agents.nix#oh-my-opencode -- --help
Nix: [packages/oh-my-opencode/package.nix]!(packages/oh-my-opencode/package.nix)

omp - A terminal-based coding agent with multi-model support (binary release)

Source: binary
License: MIT
Homepage: https://github.com/can1357/oh-my-pi
Usage: nix run github:numtide/llm-agents.nix#omp -- --help
Nix: [packages/omp/package.nix]!(packages/omp/package.nix)

opencode - AI coding agent built for the terminal

Source: binary
License: MIT
Homepage: https://github.com/anomalyco/opencode
Usage: nix run github:numtide/llm-agents.nix#opencode -- --help
Nix: [packages/opencode/package.nix]!(packages/opencode/package.nix)

pi - A terminal-based coding agent with multi-model support

Source: bytecode
License: MIT
Homepage: https://github.com/badlogic/pi-mono
Usage: nix run github:numtide/llm-agents.nix#pi -- --help
Nix: [packages/pi/package.nix]!(packages/pi/package.nix)

qoder-cli - Qoder AI CLI tool - Terminal-based AI assistant for code development

Source: binary
License: unfree
Homepage: https://qoder.com
Usage: nix run github:numtide/llm-agents.nix#qoder-cli -- --help
Nix: [packages/qoder-cli/package.nix]!(packages/qoder-cli/package.nix)

qwen-code - Command-line AI workflow tool for Qwen3-Coder models

Source: source
License: Apache-2.0
Homepage: https://github.com/QwenLM/qwen-code
Usage: nix run github:numtide/llm-agents.nix#qwen-code -- --help
Nix: [packages/qwen-code/package.nix]!(packages/qwen-code/package.nix)

AI Assistants

hermes-agent - Self-improving AI agent by Nous Research — creates skills from experience and runs anywhere

Source: source
License: MIT
Homepage: https://hermes-agent.nousresearch.com/
Usage: nix run github:numtide/llm-agents.nix#hermes-agent -- --help
Nix: [packages/hermes-agent/package.nix]!(packages/hermes-agent/package.nix)

localgpt - Local AI assistant with persistent markdown memory, autonomous tasks, and semantic search

Source: source
License: Apache-2.0
Homepage: https://github.com/localgpt-app/localgpt
Usage: nix run github:numtide/llm-agents.nix#localgpt -- --help
Nix: [packages/localgpt/package.nix]!(packages/localgpt/package.nix)

openclaw - Your own personal AI assistant. Any OS. Any Platform. The lobster way

Source: source
License: MIT
Homepage: https://openclaw.ai
Usage: nix run github:numtide/llm-agents.nix#openclaw -- --help
Nix: [packages/openclaw/package.nix]!(packages/openclaw/package.nix)

picoclaw - Tiny, fast, and deployable anywhere — automate the mundane, unleash your creativity

Source: source
License: MIT
Homepage: https://picoclaw.io
Usage: nix run github:numtide/llm-agents.nix#picoclaw -- --help
Nix: [packages/picoclaw/package.nix]!(packages/picoclaw/package.nix)

zeroclaw - Fast, small, and fully autonomous AI assistant infrastructure

Source: source
License: MIT
Homepage: https://github.com/zeroclaw-labs/zeroclaw
Usage: nix run github:numtide/llm-agents.nix#zeroclaw -- --help
Nix: [packages/zeroclaw/package.nix]!(packages/zeroclaw/package.nix)

Claude Code Ecosystem

auto-claude - Autonomous multi-agent coding framework powered by Claude AI

Source: source
License: AGPL-3.0-only
Homepage: https://github.com/AndyMik90/Auto-Claude
Usage: nix run github:numtide/llm-agents.nix#auto-claude -- --help
Nix: [packages/auto-claude/package.nix]!(packages/auto-claude/package.nix)

catnip - Developer environment that's like catnip for agentic programming

Source: binary
License: Apache-2.0
Homepage: https://github.com/wandb/catnip
Usage: nix run github:numtide/llm-agents.nix#catnip -- --help
Nix: [packages/catnip/package.nix]!(packages/catnip/package.nix)

cc-switch-cli - CLI version of CC Switch - All-in-One Assistant for Claude Code, Codex & Gemini CLI

Source: source
License: MIT
Homepage: https://github.com/SaladDay/cc-switch-cli
Usage: nix run github:numtide/llm-agents.nix#cc-switch-cli -- --help
Nix: [packages/cc-switch-cli/package.nix]!(packages/cc-switch-cli/package.nix)

ccstatusline - A highly customizable status line formatter for Claude Code CLI

Source: bytecode
License: MIT
Homepage: https://github.com/sirmalloc/ccstatusline
Usage: nix run github:numtide/llm-agents.nix#ccstatusline -- --help
Nix: [packages/ccstatusline/package.nix]!(packages/ccstatusline/package.nix)

claude-code-router - Use Claude Code without an Anthropics account and route it to another LLM provider

Source: bytecode
License: MIT
Homepage: https://github.com/musistudio/claude-code-router
Usage: nix run github:numtide/llm-agents.nix#claude-code-router -- --help
Nix: [packages/claude-code-router/package.nix]!(packages/claude-code-router/package.nix)

claude-plugins - CLI tool for managing Claude Code plugins

Source: bytecode
License: MIT
Homepage: https://github.com/Kamalnrf/claude-plugins
Usage: nix run github:numtide/llm-agents.nix#claude-plugins -- --help
Nix: [packages/claude-plugins/package.nix]!(packages/claude-plugins/package.nix)

claudebox - Sandboxed environment for Claude Code

Source: source
License: Check package
Homepage: https://github.com/numtide/claudebox
Usage: nix run github:numtide/llm-agents.nix#claudebox -- --help
Nix: [packages/claudebox/package.nix]!(packages/claudebox/package.nix)

sandbox-runtime - Lightweight sandboxing tool for enforcing filesystem and network restrictions

Source: source
License: Apache-2.0
Homepage: https://github.com/anthropic-experimental/sandbox-runtime
Usage: nix run github:numtide/llm-agents.nix#sandbox-runtime -- --help
Nix: [packages/sandbox-runtime/package.nix]!(packages/sandbox-runtime/package.nix)

skills-installer - Install agent skills across multiple AI coding clients

Source: bytecode
License: MIT
Homepage: https://github.com/Kamalnrf/claude-plugins
Usage: nix run github:numtide/llm-agents.nix#skills-installer -- --help
Nix: [packages/skills-installer/package.nix]!(packages/skills-installer/package.nix)

ACP Ecosystem

claude-code-acp - An ACP-compatible coding agent powered by the Claude Code SDK (TypeScript)

Source: source
License: Apache-2.0
Homepage: https://github.com/zed-industries/claude-code-acp
Usage: nix run github:numtide/llm-agents.nix#claude-code-acp -- --help
Nix: [packages/claude-code-acp/package.nix]!(packages/claude-code-acp/package.nix)

codex-acp - An ACP-compatible coding agent powered by Codex

Source: source
License: Apache-2.0
Homepage: https://github.com/zed-industries/codex-acp
Usage: nix run github:numtide/llm-agents.nix#codex-acp -- --help
Nix: [packages/codex-acp/package.nix]!(packages/codex-acp/package.nix)
Documentation: See [packages/codex-acp/README.md]!(packages/codex-acp/README.md) for detailed usage

Usage Analytics

ccusage - Usage analysis tool for Claude Code

Source: bytecode
License: MIT
Homepage: https://github.com/ryoppippi/ccusage
Usage: nix run github:numtide/llm-agents.nix#ccusage -- --help
Nix: [packages/ccusage/package.nix]!(packages/ccusage/package.nix)

ccusage-amp - Usage analysis tool for Amp CLI sessions

Source: bytecode
License: MIT
Homepage: https://github.com/ryoppippi/ccusage
Usage: nix run github:numtide/llm-agents.nix#ccusage-amp -- --help
Nix: [packages/ccusage-amp/package.nix]!(packages/ccusage-amp/package.nix)

ccusage-codex - Usage analysis tool for OpenAI Codex sessions

Source: bytecode
License: MIT
Homepage: https://github.com/ryoppippi/ccusage
Usage: nix run github:numtide/llm-agents.nix#ccusage-codex -- --help
Nix: [packages/ccusage-codex/package.nix]!(packages/ccusage-codex/package.nix)

ccusage-opencode - Usage analysis tool for OpenCode sessions

Source: bytecode
License: MIT
Homepage: https://github.com/ryoppippi/ccusage
Usage: nix run github:numtide/llm-agents.nix#ccusage-opencode -- --help
Nix: [packages/ccusage-opencode/package.nix]!(packages/ccusage-opencode/package.nix)

ccusage-pi - Pi-agent usage tracking for Claude Max

Source: bytecode
License: MIT
Homepage: https://github.com/ryoppippi/ccusage
Usage: nix run github:numtide/llm-agents.nix#ccusage-pi -- --help
Nix: [packages/ccusage-pi/package.nix]!(packages/ccusage-pi/package.nix)

Workflow & Project Management

agent-deck - Your AI agent command center

Source: source
License: MIT
Homepage: https://github.com/asheshgoplani/agent-deck
Usage: nix run github:numtide/llm-agents.nix#agent-deck -- --help
Nix: [packages/agent-deck/package.nix]!(packages/agent-deck/package.nix)

backlog-md - Backlog.md - A tool for managing project collaboration between humans and AI Agents in a git ecosystem

Source: source
License: MIT
Homepage: https://github.com/MrLesk/Backlog.md
Usage: nix run github:numtide/llm-agents.nix#backlog-md -- --help
Nix: [packages/backlog-md/package.nix]!(packages/backlog-md/package.nix)

beads - A distributed issue tracker designed for AI-supervised coding workflows

Source: source
License: MIT
Homepage: https://github.com/steveyegge/beads
Usage: nix run github:numtide/llm-agents.nix#beads -- --help
Nix: [packages/beads/package.nix]!(packages/beads/package.nix)

beads-rust - Fast Rust port of beads - a local-first issue tracker for git repositories

Source: source
License: MIT
Homepage: https://github.com/Dicklesworthstone/beads_rust
Usage: nix run github:numtide/llm-agents.nix#beads-rust -- --help
Nix: [packages/beads-rust/package.nix]!(packages/beads-rust/package.nix)

beads-viewer - Graph-aware TUI for the Beads issue tracker

Source: source
License: MIT
Homepage: https://github.com/Dicklesworthstone/beads_viewer
Usage: nix run github:numtide/llm-agents.nix#beads-viewer -- --help
Nix: [packages/beads-viewer/package.nix]!(packages/beads-viewer/package.nix)

cc-sdd - Spec-driven development framework for AI coding agents

Source: source
License: MIT
Homepage: https://github.com/gotalab/cc-sdd
Usage: nix run github:numtide/llm-agents.nix#cc-sdd -- --help
Nix: [packages/cc-sdd/package.nix]!(packages/cc-sdd/package.nix)

chainlink - Simple, lean issue tracker CLI designed for AI-assisted development

Source: source
License: MIT
Homepage: https://github.com/dollspace-gay/chainlink
Usage: nix run github:numtide/llm-agents.nix#chainlink -- --help
Nix: [packages/chainlink/package.nix]!(packages/chainlink/package.nix)

openspec - Spec-driven development for AI coding assistants

Source: bytecode
License: MIT
Homepage: https://github.com/Fission-AI/OpenSpec
Usage: nix run github:numtide/llm-agents.nix#openspec -- --help
Nix: [packages/openspec/package.nix]!(packages/openspec/package.nix)

ralph-tui - AI Agent Loop Orchestrator TUI

Source: source
License: MIT
Homepage: https://github.com/subsy/ralph-tui
Usage: nix run github:numtide/llm-agents.nix#ralph-tui -- --help
Nix: [packages/ralph-tui/package.nix]!(packages/ralph-tui/package.nix)

sidecar - Terminal-based development companion for AI coding agents

Source: source
License: MIT
Homepage: https://github.com/marcus/sidecar
Usage: nix run github:numtide/llm-agents.nix#sidecar -- --help
Nix: [packages/sidecar/package.nix]!(packages/sidecar/package.nix)

spec-kit - Specify CLI, part of GitHub Spec Kit. A tool to bootstrap your projects for Spec-Driven Development (SDD)

Source: source
License: MIT
Homepage: https://github.com/github/spec-kit
Usage: nix run github:numtide/llm-agents.nix#spec-kit -- --help
Nix: [packages/spec-kit/package.nix]!(packages/spec-kit/package.nix)

vibe-kanban - Kanban board to orchestrate AI coding agents like Claude Code, Codex, and Gemini CLI

Source: source
License: Apache-2.0
Homepage: https://github.com/BloopAI/vibe-kanban
Usage: nix run github:numtide/llm-agents.nix#vibe-kanban -- --help
Nix: [packages/vibe-kanban/package.nix]!(packages/vibe-kanban/package.nix)

workmux - Git worktrees + tmux windows for zero-friction parallel dev

Source: source
License: MIT
Homepage: https://github.com/raine/workmux
Usage: nix run github:numtide/llm-agents.nix#workmux -- --help
Nix: [packages/workmux/package.nix]!(packages/workmux/package.nix)

Code Review

coderabbit-cli - AI-powered code review CLI tool

Source: binary
License: unfree
Homepage: https://coderabbit.ai
Usage: nix run github:numtide/llm-agents.nix#coderabbit-cli -- --help
Nix: [packages/coderabbit-cli/package.nix]!(packages/coderabbit-cli/package.nix)

tuicr - Review AI-generated diffs like a GitHub pull request, right from your terminal

Source: source
License: MIT
Homepage: https://github.com/agavra/tuicr
Usage: nix run github:numtide/llm-agents.nix#tuicr -- --help
Nix: [packages/tuicr/package.nix]!(packages/tuicr/package.nix)

Utilities

agent-browser - Headless browser automation CLI for AI agents

Source: source
License: Apache-2.0
Homepage: https://github.com/vercel-labs/agent-browser
Usage: nix run github:numtide/llm-agents.nix#agent-browser -- --help
Nix: [packages/agent-browser/package.nix]!(packages/agent-browser/package.nix)

ck - Local first semantic and hybrid BM25 grep / search tool for use by AI and humans!

Source: source
License: MIT
Homepage: https://github.com/BeaconBay/ck
Usage: nix run github:numtide/llm-agents.nix#ck -- --help
Nix: [packages/ck/package.nix]!(packages/ck/package.nix)

copilot-language-server - GitHub Copilot Language Server - AI pair programmer LSP

Source: bytecode
License: MIT
Homepage: https://github.com/github/copilot-language-server-release
Usage: nix run github:numtide/llm-agents.nix#copilot-language-server -- --help
Nix: [packages/copilot-language-server/package.nix]!(packages/copilot-language-server/package.nix)

entire - CLI tool that captures AI agent sessions and links them to code changes

Source: source
License: MIT
Homepage: https://github.com/entireio/cli
Usage: nix run github:numtide/llm-agents.nix#entire -- --help
Nix: [packages/entire/package.nix]!(packages/entire/package.nix)

gno - Local-first knowledge engine with hybrid search, RAG Q&A, and MCP server integration

Source: source
License: MIT
Homepage: https://github.com/gmickel/gno
Usage: nix run github:numtide/llm-agents.nix#gno -- --help
Nix: [packages/gno/package.nix]!(packages/gno/package.nix)

handy - Fast and accurate local transcription app using AI models

Source: binary
License: MIT
Homepage: https://handy.computer/
Usage: nix run github:numtide/llm-agents.nix#handy -- --help
Nix: [packages/handy/package.nix]!(packages/handy/package.nix)

happy-coder - Happy Coder CLI to connect your local Claude Code to mobile device

Source: source
License: MIT
Homepage: https://github.com/slopus/happy-cli
Usage: nix run github:numtide/llm-agents.nix#happy-coder -- --help
Nix: [packages/happy-coder/package.nix]!(packages/happy-coder/package.nix)

mcporter - TypeScript runtime and CLI for the Model Context Protocol

Source: source
License: MIT
Homepage: https://github.com/steipete/mcporter
Usage: nix run github:numtide/llm-agents.nix#mcporter -- --help
Nix: [packages/mcporter/package.nix]!(packages/mcporter/package.nix)

openskills - Universal skills loader for AI coding agents - install and load Anthropic SKILL.md format skills in any agent

Source: source
License: Apache-2.0
Homepage: https://github.com/numman-ali/openskills
Usage: nix run github:numtide/llm-agents.nix#openskills -- --help
Nix: [packages/openskills/package.nix]!(packages/openskills/package.nix)

qmd - mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local

Source: source
License: MIT
Homepage: https://github.com/tobi/qmd
Usage: nix run github:numtide/llm-agents.nix#qmd -- --help
Nix: [packages/qmd/package.nix]!(packages/qmd/package.nix)
Documentation: See [packages/qmd/README.md]!(packages/qmd/README.md) for detailed usage

rtk - CLI proxy that reduces LLM token consumption by 60-90% on common dev commands

Source: source
License: MIT
Homepage: https://github.com/rtk-ai/rtk
Usage: nix run github:numtide/llm-agents.nix#rtk -- --help
Nix: [packages/rtk/package.nix]!(packages/rtk/package.nix)

showboat - Create executable demo documents showing and proving an agent's work

Source: source
License: Apache-2.0
Homepage: https://github.com/simonw/showboat
Usage: nix run github:numtide/llm-agents.nix#showboat -- --help
Nix: [packages/showboat/package.nix]!(packages/showboat/package.nix)

Installation

Using Nix Flakes (Recommended)

Add to your system configuration:

{
  inputs = {
    llm-agents.url = "github:numtide/llm-agents.nix";
  };

  # In your system packages:
  environment.systemPackages = with inputs.llm-agents.packages.${pkgs.stdenv.hostPlatform.system}; [
    claude-code
    opencode
    gemini-cli
    qwen-code
    # ... other tools
  ];
}

Using Overlay

Alternatively, use the overlay to access packages under the llm-agents namespace:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
    llm-agents.url = "github:numtide/llm-agents.nix";
  };

  outputs = { nixpkgs, llm-agents, ... }: {
    # NixOS / nix-darwin configuration
    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [{
        nixpkgs.overlays = [ llm-agents.overlays.default ];
        environment.systemPackages = [
          pkgs.llm-agents.claude-code
          pkgs.llm-agents.codex
          pkgs.llm-agents.gemini-cli
        ];
      }];
    };
  };
}

Try Without Installing

Browse all available tools with the interactive launcher:

nix run github:numtide/llm-agents.nix

This opens an fzf picker listing every package with its description. Select one and it will be run via nix run.

Or run a specific tool directly:

nix run github:numtide/llm-agents.nix#claude-code
nix run github:numtide/llm-agents.nix#opencode
nix run github:numtide/llm-agents.nix#gemini-cli
nix run github:numtide/llm-agents.nix#qwen-code
# etc...

Binary Cache

Pre-built binaries are available from the Numtide binary cache. All packages are built daily via CI and pushed to the cache, so you can avoid compiling from source.

This cache is automatically configured when this flake is used directly (e.g nix run github:numtide/llm-agents.nix#claude-code)

To use the binary cache when using this flake as an input, add nixConfig to your flake:

{
  nixConfig = {
    extra-substituters = [ "https://cache.numtide.com" ];
    extra-trusted-public-keys = [ "niks3.numtide.com-1:DTx8wZduET09hRmMtKdQDxNNthLQETkc/yaX7M4qK0g=" ];
  };
}

Alternatively, you can configure this system-wide in your NixOS configuration:

nix.settings = {
  extra-substituters = [ "https://cache.numtide.com" ];
  extra-trusted-public-keys = [
    "niks3.numtide.com-1:DTx8wZduET09hRmMtKdQDxNNthLQETkc/yaX7M4qK0g="
  ];
};

Development

Setup Development Environment

nix develop

Building Packages

# Build a specific package
nix build .#claude-code
nix build .#opencode
nix build .#qwen-code
# etc...

Code Quality

# Format all code
nix fmt

# Run checks
nix flake check

Package Details

Platform Support

All packages support:

x86_64-linux
aarch64-linux
x86_64-darwin
aarch64-darwin

Experimental Features

This repository serves as a laboratory for exploring how Nix can enhance AI-powered development:

Current Experiments

Sandboxed execution: claudebox demonstrates transparent, sandboxed AI agent execution
Provider abstraction: claude-code-router explores decoupling AI interfaces from specific providers
Tool composition: Investigating how multiple AI agents can work together in Nix environments

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Run nix fmt before committing
Submit a pull request

License

Individual tools are licensed under their respective licenses.

The Nix packaging code in this repository is licensed under MIT.