# Endor Labs AI Plugins

> Public distribution repository for Endor Labs Agent Kit packages across
> Claude Code, Codex, Gemini CLI, Antigravity CLI, Cursor, Cursor SDK, and root
> MCP support context.

## Start Here

- `README.md`: public distribution front door for humans and agents.
- `docs/for-agents.md`: agent operating rules for installing, reviewing,
  editing, validating, and syncing this mirror.
- `docs/distribution-sync.md`: exact source-to-mirror sync workflow.
- `docs/plugin-release-checklist.md`: release validation matrix.
- `plugins/README.md`: generated provider package index.

## Source Boundary

- Source repo: [🐙 The Endor Labs Agent Kit](https://github.com/endorlabs/endor-labs-agent-kit/tree/main)
- Public mirror: [🐙 Endor Labs AI Plugins](https://github.com/endorlabs/ai-plugins/tree/main)
- Generated package tree: `plugins/`
- Cursor package: `.cursor-plugin/`, `agents/`, `skills/`, `hooks/`, `assets/logo.png`
- Cursor SDK automation: `cursor-sdk/`
- Root MCP/Gemini support context: `.mcp.json` and non-installable `GEMINI.md`

Generated provider packages under `plugins/` should come from Agent Kit
publication output. Cursor package files should also come from Agent Kit
publication output. Behavior changes belong in the source repo first.

## Distribution Paths

- Claude Code: `.claude-plugin/marketplace.json`,
  `plugins/claude/endor-labs-agent-kit/`, and
  `plugins/claude/ai-plugins/`
- Codex: `.agents/plugins/marketplace.json` and
  `plugins/codex/endor-labs-agent-kit/`
- Gemini CLI: `plugins/gemini/endor-labs-agent-kit/`
- Antigravity CLI: `plugins/antigravity/endor-labs-agent-kit/`
- Cursor: `.cursor-plugin/`, `agents/`, `skills/`, `hooks/`, `assets/logo.png`
- Cursor SDK: `cursor-sdk/`
- Root support: `.mcp.json`, `GEMINI.md`

## Common Validation

```bash
AGENT_KIT_REPO="/path/to/endor-labs-agent-kit"

for skill in skills/*; do python3 scripts/quick_validate.py "$skill"; done
python3 -m json.tool .claude-plugin/marketplace.json >/dev/null
python3 -m json.tool .agents/plugins/marketplace.json >/dev/null
python3 -m json.tool .cursor-plugin/marketplace.json >/dev/null
python3 -m json.tool .cursor-plugin/plugin.json >/dev/null
python3 -m json.tool .mcp.json >/dev/null
test -f GEMINI.md
test ! -e gemini-extension.json
test -f plugins/gemini/endor-labs-agent-kit/gemini-extension.json
test ! -e plugins/gemini/endor-labs-agent-kit.zip
diff -qr "$AGENT_KIT_REPO/plugins" ./plugins
diff -qr "$AGENT_KIT_REPO/.cursor-plugin" ./.cursor-plugin
diff -qr "$AGENT_KIT_REPO/agents" ./agents
diff -qr "$AGENT_KIT_REPO/hooks" ./hooks
diff -qr "$AGENT_KIT_REPO/cursor-sdk" ./cursor-sdk
diff -q "$AGENT_KIT_REPO/assets/logo.png" assets/logo.png
git diff --check
```

## Safety Rules

- Setup must not run scans.
- Setup must not run `endorctl host-check`.
- Do not print, persist, or copy secret values.
- Do not auto-install host or language tooling.
- Live Endor API evidence requires explicit approval and namespace provenance.