Agent21

Agent21 是面向开发团队的本地 CLI：团队只维护 AGENTS.md、.agents/skills/ 和可选 .mcp.json，Agent21 将它们安全同步到 Claude Code、Codex、Cursor、OpenCode 和 Pi。

Install and First Use

python -m pip install agent21
cd /path/to/your/project
agent21 init --agents claude,codex,cursor,opencode,pi --mode auto --yes
agent21 sync
agent21 doctor

init 只在当前项目创建权威配置，遇到未托管冲突会停止；sync --dry-run 可在写入前查看计划。 doctor 检查配置、manifest、生成物漂移、Skills、MCP、锁和中断事务。

管理项目级 Skill：

agent21 skill install path/to/my-skill
agent21 skill list
agent21 skill remove my-skill

本地 Skill 必须包含根 SKILL.md。Git 来源也支持显式 URL；Agent21 只复制内容， 不执行 Skill 代码、不保存 Git 凭证，也不修改用户全局 Agent 配置。

First Contributor Validation

首次贡献者可以在 15 分钟内完成标准验证准备：

  1. 安装 Git、uv 和 Python 3.11 或更高版本。

  2. 克隆仓库并进入项目根目录。

  3. 同步锁定依赖：

    uv sync --locked --group dev

  4. 运行贡献者门禁：

    uv run nox -s pr

  5. 只排查当前失败项；不要自动更新快照，也不要使用真实凭证。

pr 会话覆盖格式、lint、类型、单元、适配器、契约、集成、安全快速子集和覆盖率门槛。 文档专用变更在 CI 中会走轻量路径，但本地仍建议运行 uv run nox -s pr。

Targeted Checks

uv run pytest -m unit
uv run pytest -m "adapter or contract"
uv run pytest -m integration
uv run pytest -m safety
uv run pytest -m snapshot
uv run nox -s package

快照只在产品契约有意变化时本地更新：

uv run pytest -m snapshot --snapshot-update
git diff -- tests
uv run pytest -m snapshot

CI 中不得运行 --snapshot-update。

Release Validation

发布候选版本必须通过主分支门禁、三平台 release session、包构建、干净安装和公开 CLI 冒烟检查。 详细流程见 docs/release-validation.md。

Contributing and Security

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Jewei from gravatar.com Jewei

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

agents-md ai cli coding-agent mcp

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent21-0.1.0.tar.gz (278.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent21-0.1.0-py3-none-any.whl (36.8 kB view details)

Uploaded Python 3

File details

Details for the file agent21-0.1.0.tar.gz.

File metadata

  • Download URL: agent21-0.1.0.tar.gz
  • Upload date:
  • Size: 278.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent21-0.1.0.tar.gz
Algorithm Hash digest
SHA256 6cf274beec0d45fb3d2f69e5ff0d6493a877a56238bf5c8e913bcfc89b0b8c7b
MD5 0578fa66aa32c7f5d14b332d4ede2bad
BLAKE2b-256 c0bf9fe365a33e27e576bac7dd16ae53d1a1728a95e68c4984345942021d2230

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent21-0.1.0.tar.gz:

Publisher: release.yml on jeweis/agent21

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agent21-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: agent21-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 36.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agent21-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 14a724ad7430d1b00c63b33306887f8ac11f9cbbb4fa2537b7e0f9fcddfce192
MD5 087de129c1ad4eb3d85aaf2538b89e0e
BLAKE2b-256 4ddedb683572395fff38d50bd7fcbe5530e03f3272faf827b43097d6734ef549

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent21-0.1.0-py3-none-any.whl:

Publisher: release.yml on jeweis/agent21

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page