agent-container-pack (acpack)

CLI tool that generates CLAUDE.md/AGENTS.md and MCP configurations from a single agentpack.yml manifest.

Why acpack?

Claude Code and Codex CLI have different configuration formats. acpack uses a single YAML manifest (agentpack.yml) as the source of truth, generating the appropriate files for each tool:

• CLAUDE.md / AGENTS.md - Project instructions
• .claude/settings.json - Claude Code MCP configuration
• codex.config.toml - Codex CLI MCP configuration

Installation

# With uvx (no install required)
uvx --from acpack acpack --help

# Or install globally (recommended)
uv tool install acpack
acpack --help

# Or with pip
pip install acpack

Usage

New Project

# 1. Initialize project (creates .devcontainer/ and agentpack.yml)
cd my-project
acpack init

# 2. Edit agentpack.yml (project name, MCP servers, etc.)
vim agentpack.yml

# 3. Generate configuration files
acpack generate --write

Existing Project

# 1. Create agentpack.yml manually or via init
acpack init

# 2. Edit agentpack.yml to match your project
vim agentpack.yml

# 3. Generate
acpack generate --write

Team Workflow

# Team members clone the repo and run:
git clone <repo>
cd <repo>
acpack generate --write
# → Ready to use Claude Code / Codex CLI

Workflow Diagram

acpack init          # Run once
       ↓
agentpack.yml           # Edit this file (single source of truth)
       ↓
acpack generate      # Run after each yml change
       ↓
CLAUDE.md, AGENTS.md    # Auto-generated (don't edit manually)
.claude/settings.json
codex.config.toml

Commands

acpack init

Initialize a new agentpack project with devcontainer and manifest skeleton.

acpack init [directory] [--template <source>] [--stack <id>] [--force]

acpack generate

Generate configuration files from agentpack.yml.

acpack generate [--write] [--directory <path>]

Manifest Format

Create an agentpack.yml in your project root:

version: "1"

project:
  name: "my-project"
  description: "Project description"

stack: python

stacks:
  python:
    detect:
      any: ["pyproject.toml", "requirements.txt"]
    deps: "uv sync"
    lint: "uv run ruff check ."
    typecheck: "uv run ty check"
    test: "uv run pytest"
    run: "uv run python main.py"

mcp:
  servers:
    Ref:
      transport: http
      url: "https://api.ref.tools/mcp"
      env:
        X_REF_API_KEY: "${env:X_REF_API_KEY}"

workflows:
  - name: "Development Flow"
    steps:
      - "uv run ruff format . && uv run ruff check ."
      - "uv run pytest"

pre_commit: ["prettier", "ruff", "ty"]

safety:
  preset: default

See docs/plans/2026-01-02-agentpack-v0.1-design.md for full manifest specification.

Generated Files

Development

# Install dependencies
uv sync

# Run tests
uv run pytest

# Lint and format
uv run ruff format .
uv run ruff check .

# Type check
uv run ty check

License

MIT