FP Enforcer

Functional programming enforcement for AI coding harnesses: portable Agent Skills, curated pattern packs, a stdlib-only Python CLI, and per-project hooks for Cursor, Claude Code, Codex, and Antigravity.

Vendor-neutral Open Plugins root + Agent Skills. Host adapters build installable marketplaces; the Python package on PyPI remains the runtime used by fp-enforcer wire.

Install (plugins)

One curl one-liner per host. Plain install upgrades in place (replaces any prior managed install). Uninstall is a separate script — there is no --uninstall on install.

Replace REF with master (or a tag) as needed.

Claude Code

Install:

curl -fsSL https://raw.githubusercontent.com/theocarranza/fp-enforcer/master/adapters/claude/install.sh \
  | bash -s -- --repo theocarranza/fp-enforcer --ref master

Then:

/plugin install fp-enforcer@fp-enforcer-local

Uninstall:

curl -fsSL https://raw.githubusercontent.com/theocarranza/fp-enforcer/master/adapters/claude/uninstall.sh \
  | bash -s -- --repo theocarranza/fp-enforcer --ref master

Cursor

Install (curl → ~/.cursor/plugins/local):

curl -fsSL https://raw.githubusercontent.com/theocarranza/fp-enforcer/master/adapters/cursor/install.sh \
  | bash -s -- --repo theocarranza/fp-enforcer --ref master

Uninstall:

curl -fsSL https://raw.githubusercontent.com/theocarranza/fp-enforcer/master/adapters/cursor/uninstall.sh \
  | bash -s -- --repo theocarranza/fp-enforcer --ref master

Codex

Install:

curl -fsSL https://raw.githubusercontent.com/theocarranza/fp-enforcer/master/adapters/codex/install.sh \
  | bash -s -- --repo theocarranza/fp-enforcer --ref master

Codex marketplace manifests use .agents/plugins/marketplace.json (and mirrored accepted paths).

Uninstall:

curl -fsSL https://raw.githubusercontent.com/theocarranza/fp-enforcer/master/adapters/codex/uninstall.sh \
  | bash -s -- --repo theocarranza/fp-enforcer --ref master

From a clone: ./adapters/<host>/install.sh or ./adapters/<host>/uninstall.sh. Dry-run: add --dry-run.

Runtime (PyPI)

Per-project wiring still uses the CLI:

pipx install fp-enforcer
# or: uv tool install fp-enforcer

fp-enforcer wire --dest /path/to/project --clients cursor,claude,codex,antigravity

Skills:

Authoring / build

./scripts/validate.sh
./scripts/build_all.sh

Version lockstep is enforced across VERSION, .plugin/plugin.json, host manifests, adapter templates, and pyproject.toml. Do not hand-edit dist/.

Canonical skills live under skills/<name>/SKILL.md (portable frontmatter only: name, description, license). The same files are mirrored under fp_enforcer/skills/ for wheel package data. Host overlays live in adapters/<host>/skill-overlay.md.

Layout

.plugin/plugin.json          Open Plugins manifest
skills/                      Portable Agent Skills
fp_enforcer/                 Python package (CLI, rules, adapters, mirrored skills)
adapters/{cursor,claude,codex}/
scripts/validate.sh
scripts/build_all.sh
hooks/hooks.json             Valid no-op plugin hook descriptor

License

MIT