Agents Pack
Open source · Local-first CLI

Teach every coding agent how you work.

Agents Pack maintains one set of instructions, skills, and subagents, then renders them in the native format each agent actually reads. Install it once and Claude Code, Codex, and Cursor pick up the same working knowledge — without an account, a server, or anything overwritten behind your back.

Install — macOS and Linux
curl -fsSL https://farfarawaylabs.github.io/agentspackai/install.sh | sh

Get startedRead the docs
Works with
Claude Code · Codex · Cursor
In the core pack
24 skills · 6 subagents · 1 instruction set
Current pack
0.26.0
The problem

One capability. Three formats. Three copies to keep in sync.

Claude Code, Codex, and Cursor each expect instructions, skills, and subagents in different places, in different formats, with different discovery rules. Maintain them by hand and you write the same capability three times — then find out it drifted when an agent quietly stops following it.

You maintain

One canonical source

  • Core instructions
  • Skills
  • Subagents

Official pack content, plus anything you author yourself.

Agents Pack renders

  • Claude Code

    • .claude/rules/agents-pack/
    • .claude/skills/
    • .claude/agents/

  • Codex

    • AGENTS.md (managed block)
    • .agents/skills/
    • .codex/agents/

  • Cursor

    • .cursor/rules/agents-pack/
    • .cursor/skills/
    • .cursor/agents/

Repository-scope paths. Agents Pack records a hash for every file it writes, so a hand edit is reported as drift instead of being silently replaced.

How it works

Three commands, then it is out of your way.

Agents Pack is a filesystem tool. It writes native files, records what it owns, and gets out of the loop.

  1. Install the CLI

    One standalone executable with its checksum verified, placed in ~/.local/bin without sudo. No Bun, Node.js, or npm required.

    curl -fsSL https://farfarawaylabs.github.io/agentspackai/install.sh | sh

  2. Initialize your project

    Choose repository or global scope, the agents you use, and the components you want. Agents Pack shows the exact plan before it writes anything.

    agents-pack init

  3. Just work

    Each agent discovers the rendered files through its own native mechanism. Nothing to wire up, no extension to install, no process to keep running.

The core pack

24 skills and 6 subagents, maintained for you.

Skills are loaded only when a task calls for them, so your always-on instructions stay short. Ask your agent in plain language or name a skill by its ID.

Workflows

Debug systematically

Trace reproducible failures to evidence-backed root causes and verify fixes.

ap-debugWorkflows

Review a plan

Challenge a plan for mistakes, omissions, assumptions, risks, and simpler alternatives.

ap-review-planSecurity

Run a security audit

Inspect concrete attack surfaces, validate findings, and report actionable security risks.

ap-security-auditBackend

Develop APIs

Build thin, secure, documented API layers over reusable business and data logic.

ap-develop-apisFrontend

Design distinctive frontends

Create intentional, production-grade interfaces and maintain the project design system.

ap-frontend-designBackend

Write database queries

Write correct, secure, performant queries with sound transaction and indexing choices.

ap-write-database-queriesWorkflows

Start a development session

Orient a new session from the project's requirements, technical choices, and current work.

ap-start-dev-sessionPlanning

Create a product requirements document

Interview the user, shape the product, and write a clear evidence-aware PRD.

ap-create-prdManagement

Manage Agents Pack

Manage official and user-owned cross-agent components through the safe lifecycle CLI.

ap-manage-agents-pack
Subagents

Specialized agents rendered into each provider's native definition format, for delegated review, implementation, and research work.

Browse all 24 skillsSee the core instruction set

Safety

It would rather refuse than guess.

Agents Pack edits files you already own, in repositories you already ship. Every mutation is planned, hashed, and reversible — and it prefers a clear refusal over a speculative merge.

  • Preview is honest

    --dry-run runs the real planner and writes nothing — no provider files, no installation state, no cache.

  • Unexpected edits stop the operation

    Agents Pack records a SHA-256 hash for every file it writes. If one changed underneath it, the command stops and tells you which file.

  • Shared files stay shared

    Codex instructions live in a marked block inside AGENTS.md. Everything outside that block is yours and is never touched.

  • Writes are transactional

    A failed operation restores the previous filesystem state, and rerunning an interrupted command recovers before it replans.

agents-pack status

Read-only. Reports the health of every managed output.

  • cleanMatches what Agents Pack last wrote
  • missingExpected managed content is gone
  • modifiedContent differs from the recorded output
  • malformedStructure or markers are invalid

Anything other than clean stops mutating commands until you resolve it. See Safety and drift.

Day-to-day use

You do not have to remember the commands.

Every installation includes the required ap-manage-agents-pack skill, which teaches your agent that the CLI is the source of truth and that generated files are never edited directly. Ask for the outcome you want.

  • Check my Agents Pack installation and explain whether everything is healthy. Do not change anything.

  • Install the ap-frontend-design skill. Preview the change first and wait for my approval before applying it.

  • Fork ap-debug into a user-owned skill named my-debug, then show me which canonical file I should customize.

  • Synchronize my user-owned Agents Pack components, then verify that every managed file is clean.

Open source

Nothing here is a black box.

Agents Pack writes instructions that shape how your coding agents behave. You should be able to read every word of that before you trust it, so all of it is public.

  • src/

    The CLI itself

    The TypeScript source for the planner, the writers, and the ownership checks — plus the test suite that proves them.

  • content/

    Every component

    The instruction set, all skills, and all subagents are plain Markdown. Read them, diff them, and see exactly what your agent is told.

  • install.sh

    The installer

    The same script the install command fetches. If you would rather not pipe anything to a shell, read it first and run it yourself.

  • registry/

    The release process

    How pack versions are published and resolved, so you can verify which content a given version actually contains.

Browse the source on GitHubFork a component and make it yours

Set it up once. Every agent benefits.

macOS and Linux, ARM64 and x64. One executable, checksum-verified, no sudo. Then run agents-pack init in your project.

curl -fsSL https://farfarawaylabs.github.io/agentspackai/install.sh | sh

Installation guideInitializing a project