Skip to main content

AI Programming: Agent + Skill Workflow Framework — one .cataforge/ spec, many IDEs (Claude Code, Cursor, Codex, OpenCode).

Project description

CataForge

PyPI Python License: MIT Tests

CataForge 把同一份 .cataforge/ 工作流规范部署到 Claude Code、Cursor、CodeX、OpenCode 四个 AI IDE,省去你为每个 IDE 重写 Agent / Skill / Hook / MCP 的工作。

同一份 .cataforge/ 规范同时驱动 Claude Code、Cursor、CodeX、OpenCode

60 秒跑通第一个部署

# 安装(推荐 uv tool)
uv tool install cataforge

# 在你的项目根目录下执行
cataforge bootstrap --platform cursor    # 或 claude-code / codex / opencode

成功标志:终端最后一行打印 Diagnostics complete.。在对应 IDE 中打开项目即可使用。

先看不写盘:cataforge bootstrap --platform cursor --dry-run

零安装试用:uvx cataforge bootstrap --platform cursor --dry-run

其它安装方式(pip / 项目 venv / Windows 最小清单)见 安装指南

它为你解决什么

问题 CataForge 的做法
在 4 个 IDE 之间维护 4 套 Agent / Skill 定义 写一份 .cataforge/cataforge deploy 翻译成各 IDE 的原生产物
某 IDE 不支持某个能力 PlatformAdapter 按能力矩阵自动降级(rules_injection / prompt_check),而不是直接放弃
升级时怕覆盖手改的文件 upgrade apply 前自动快照到 .cataforge/.backups/<ts>/upgrade rollback 可回退
项目从零搭 SDLC 流程 内置 13 个 Agent + 26 个 Skill,覆盖需求 → 架构 → 设计 → TDD → 评审

一份 .cataforge/ 在四平台分别落盘的产物对照

下一步看哪里

你想…… 去这里
5 分钟跑通第一个部署 快速开始
一页纸速查(平台 / CLI / 产物路径) 速查卡
在你的 IDE 中真实落地 平台适配指南
端到端验证四平台 手动验证
升级到新版本 升级指南
查 CLI 命令参数 CLI 参考
改配置 配置参考
定制 Agent / Skill Agent & Skill 清单
理解内部如何工作 架构概览
解决报错 故障排查 · FAQ

完整文档索引 →

贡献 · License

Project details


Download files

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

Source Distribution

cataforge-0.1.15.tar.gz (482.6 kB view details)

Uploaded Source

Built Distribution

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

cataforge-0.1.15-py3-none-any.whl (453.6 kB view details)

Uploaded Python 3

File details

Details for the file cataforge-0.1.15.tar.gz.

File metadata

  • Download URL: cataforge-0.1.15.tar.gz
  • Upload date:
  • Size: 482.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for cataforge-0.1.15.tar.gz
Algorithm Hash digest
SHA256 4d8c744ed2da7ae7cfdc02f51b03fae2e7b9586caf6e05ffd455b4d8242d7d11
MD5 f743932a84f795f619e9de0921569633
BLAKE2b-256 56ecbd7dc0c95d73416c8e06a24cdb6a5a462d1e703cf391d932662434a5f8aa

See more details on using hashes here.

Provenance

The following attestation bundles were made for cataforge-0.1.15.tar.gz:

Publisher: publish.yml on lync-cyber/CataForge

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

File details

Details for the file cataforge-0.1.15-py3-none-any.whl.

File metadata

  • Download URL: cataforge-0.1.15-py3-none-any.whl
  • Upload date:
  • Size: 453.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for cataforge-0.1.15-py3-none-any.whl
Algorithm Hash digest
SHA256 99fd86abff9a8bff06186e8aa4b81850a068ccbd5436a089daf8dc354e9e7040
MD5 122281ad4ca3abd6b1fcb45344ebd56b
BLAKE2b-256 5badbde9841a2b339485c42dffaed436b44116aa6622e004695366ea49483f4a

See more details on using hashes here.

Provenance

The following attestation bundles were made for cataforge-0.1.15-py3-none-any.whl:

Publisher: publish.yml on lync-cyber/CataForge

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