This project has been archived by its maintainers, and is no longer receiving any updates.
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 configurationcodex.config.toml- Codex CLI MCP configuration
Installation
# With uvx (no install required)
uvx --from agent-container-pack acpack --help
# Or install globally (recommended)
uv tool install agent-container-pack
acpack --help
# Or with pip
pip install agent-container-pack
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]
| Option | Description | Default |
|---|---|---|
directory |
Target directory | . |
--template |
Template source | github:ryoooo/acpack-template-default |
--stack |
Stack to use (python, node, etc.) | python |
--force |
Overwrite existing files | false |
acpack generate
Generate configuration files from agentpack.yml.
acpack generate [--write] [--directory <path>]
| Option | Description | Default |
|---|---|---|
--write |
Write files to disk (otherwise dry-run) | false |
--directory |
Project directory | . |
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
| File | Purpose |
|---|---|
CLAUDE.md |
Claude Code project instructions |
AGENTS.md |
Codex CLI project instructions (same content) |
.claude/settings.json |
Claude Code MCP server configuration |
codex.config.toml |
Codex CLI MCP server configuration |
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
Metadata
Release files for agent-container-pack 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agent_container_pack-0.1.1.tar.gz | 55.2 kB | Without provenance | Details for agent_container_pack-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agent_container_pack-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for agent_container_pack-0.1.1-py3-none-any.whl |
Total release size: 73.4 kB
Release files / agent_container_pack-0.1.1.tar.gz
| Download URL | agent_container_pack-0.1.1.tar.gz |
|---|---|
| Size | 55.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b0f0b20895dd142453f575b60d26797d3ef04b534864f8c2208a8852ab17ea05
|
|
BLAKE2b-256 checksum How to use checksums |
c896c4e590cdea08606bd544b22b904093ed11629fadcecf1f38cfd37577a174
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / agent_container_pack-0.1.1-py3-none-any.whl
| Download URL | agent_container_pack-0.1.1-py3-none-any.whl |
|---|---|
| Size | 18.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
211d8a7bd40130d5f31fddc0bb99524be96780fdb739cb31b6b83a664117e75e
|
|
BLAKE2b-256 checksum How to use checksums |
a35bf3b9f45b46851576cd2da75de8fcd31db5fecbfc781a9ba49c9cbafd95f5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for agent-container-pack 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.