🧩 Endor Labs AI Plugins

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

Important

This repo is the distribution mirror. Agent behavior, generated package shape, guardrails, tests, and source documentation are owned by 🐙 The Endor Labs Agent Kit.

Current generated Agent Kit package version: 2.2.1. Agent Kit maintainer merges open or update generated distribution PRs in this repo, but they do not automatically bump package versions. Version bumps are intentional release actions from the source repo.

🚦 Start Here

I want to...	Go here
🚀 Install a host package	Quick Start
🧾 See what changed	CHANGELOG.md
🖱️ Use Cursor IDE agents	Cursor IDE
🐍 Run Cursor SDK automation	cursor-sdk/README.md
🤖 Ask an agent to review this mirror	docs/for-agents.md
📦 Sync from Agent Kit source	docs/distribution-sync.md
✅ Prepare a release	docs/plugin-release-checklist.md

A machine-readable index is available in llms.txt.

🧭 Browse The Distribution

Area	What is inside
🧑‍💻 Claude Code	.claude-plugin/marketplace.json, plugins/claude/endor-labs-agent-kit/, legacy plugins/claude/ai-plugins/
🧠 Codex	.agents/plugins/marketplace.json, plugins/codex/endor-labs-agent-kit/
💎 Gemini CLI	plugins/gemini/endor-labs-agent-kit/
🛫 Antigravity CLI	plugins/antigravity/endor-labs-agent-kit/
🖱️ Cursor IDE	.cursor-plugin/marketplace.json, plugins/cursor/endor-labs-agent-kit/
🐍 Cursor SDK	cursor-sdk/ Python launcher, generated prompts, and agent definitions
🔁 Root support	Claude compatibility surfaces and non-installable GEMINI.md context
🧾 Release docs	docs/, llms.txt, plugins/README.md

🚀 Quick Start

Pick your host, install the package, then run setup. Setup checks local readiness and does not run scans.

Use the endor-agent-kit-setup skill to check Endor Agent Kit readiness. Do not run scans.

Claude Code

Install the preferred package id:

/plugin marketplace add endorlabs/ai-plugins
/plugin install endor-labs-agent-kit@endorlabs
/reload-plugins
/agents

Existing Claude Code users pinned to the historical id can keep using:

/plugin marketplace add endorlabs/ai-plugins
/plugin install ai-plugins@endorlabs
/reload-plugins
/agents

Do not enable endor-labs-agent-kit@endorlabs and ai-plugins@endorlabs in the same Claude profile for normal use. They expose the same setup skill and agents.

Details: plugins/claude/endor-labs-agent-kit/README.md.

Codex

Add the Endor Labs marketplace, restart Codex, then install Endor Labs Agent Kit from the Codex plugin directory:

codex plugin marketplace add endorlabs/ai-plugins \
  --sparse .agents/plugins \
  --sparse plugins/codex/endor-labs-agent-kit

After installation, start a new Codex thread and ask setup to install or update the bundled Endor custom agents:

Use the endor-agent-kit-setup skill to check readiness and install the bundled Codex custom agents.

Details: plugins/codex/endor-labs-agent-kit/README.md.

Cursor IDE

Install the current public Cursor Marketplace package from Cursor Agent chat:

/add-plugin endorlabs

Marketplace page: cursor.com/marketplace/endorlabs.

Open the target project folder, reload Cursor if prompted, then run setup:

Use the endor-agent-kit-setup skill to set up endorctl.

Cursor SDK

Use the SDK lane for Python automation, CI, orchestration, backend services, or Cursor cloud agents:

python3 -m pip install -r cursor-sdk/requirements.txt
export CURSOR_API_KEY="crsr_..."
python cursor-sdk/run_cursor_agent.py endor-configuration-automation-agent \
  --workspace /path/to/repo \
  "Explain what evidence you need to assess GitHub onboarding gaps. Keep it read-only."

Cloud run shape:

python cursor-sdk/run_cursor_agent.py endor-sca-remediation-agent \
  --mode cloud \
  --repo-url https://github.com/your-org/your-repo \
  --ref main \
  "Prepare a remediation plan only. Do not edit files or open a PR."

Gemini CLI

Install the generated Gemini extension package from the public repository:

git clone https://github.com/endorlabs/ai-plugins
gemini extensions install ./ai-plugins/plugins/gemini/endor-labs-agent-kit
gemini extensions list

For local validation from a checkout, install the generated extension directory:

gemini extensions install ./plugins/gemini/endor-labs-agent-kit

Restart Gemini CLI after installing or reinstalling the extension.

Google documents Antigravity CLI as the consumer transition path for Gemini CLI. Use the Gemini package for supported Gemini CLI environments and compatibility checks; use the Antigravity package below for affected Gemini CLI consumer accounts.

Details: plugins/gemini/endor-labs-agent-kit/README.md.

Antigravity CLI

Clone the distribution repo, then install the generated plugin directory:

git clone https://github.com/endorlabs/ai-plugins
cd ai-plugins
agy plugin validate ./plugins/antigravity/endor-labs-agent-kit
agy plugin install ./plugins/antigravity/endor-labs-agent-kit
agy plugin list

Restart Antigravity CLI if newly installed skills or subagents are not visible.

Details: plugins/antigravity/endor-labs-agent-kit/README.md.

⚡ Agent Quick Starts

Agent	Best for	Cursor / SDK name	Safety	First prompt
🔎 AI SAST Remediation	Triage Endor AI SAST findings, use exploit and remediation context, and open requested change requests	endor-ai-sast-remediation-agent	approval-gated mutating	Triage AI SAST findings for this repository. Do not edit files, open a PR/MR, create a ticket, or write an Endor policy until I approve the specific gate.
🧭 CI/CD And Supply Chain Posture	Assess CI/CD and supply chain posture from existing Endor findings and read-only GitHub configuration evidence	endor-cicd-posture-agent	read-only	Assess CI/CD and supply chain posture for namespace <namespace>. Keep it read-only and validate the deterministic score.
📡 Configuration Automation	Probe GitHub.com onboarding gaps and prescribe Endor scan profiles, toolchains, package integrations, and reachability setup	endor-configuration-automation-agent	read-only	Explain what evidence you need to assess GitHub onboarding gaps for this repository. Keep it read-only.
⚖️ Dependency Reviewer	Review an exact package decision, package risk, or repository dependencies through one bounded profile	endor-dependency-reviewer-agent	read-only	Review this repository's exact direct dependencies with the repository-review profile. Keep it read-only.
🔍 Findings Browser	Browse, filter, and summarize existing Endor findings	endor-findings-browser-agent	read-only	Show the critical and high reachable findings for namespace <namespace>. Keep it read-only.
🚨 Malware Responder	Correlate current software-supply-chain malware intelligence with tenant package inventory and report containment guidance	endor-malware-responder-agent	read-only	Assess tenant exposure to malware campaign <campaign>. Keep it read-only and report evidence gaps.
⬆️ OSS Upgrade Investigator	Analyze Endor platform upgrade impact with VersionUpgrade, CIA, findings, and manifest context	endor-oss-upgrade-investigator-agent	read-only	Show the safest upgrade path for repository <owner>/<repo> package lodash. Keep it read-only.
🗺️ Remediation Planning	Preview safe dependency remediation options without opening PRs	endor-remediation-planning-agent	read-only	Preview remediation options for this repository. Do not edit files or open a PR/MR.
🛠️ SCA Remediation	Find safe dependency remediation paths with Endor SCA evidence	endor-sca-remediation-agent	approval-gated mutating	Inspect this repository and prepare a remediation plan only. Do not edit files, create branches, push, open a PR/MR, create a ticket, or write Endor policy.
🧯 Troubleshooting	Diagnose setup, scan, auth, policy, or integration issues	endor-troubleshooting-agent	read-only	Diagnose this Endor issue from redacted error text and read-only tenant evidence. Keep it read-only.
💬 Vulnerability Explainer	Understand a specific CVE, GHSA, or Endor vulnerability and what to do next	endor-vulnerability-explainer-agent	read-only	Explain CVE-2021-44228 using verified Endor evidence. Keep it read-only.
🧰 Setup	Check host, auth, namespace, endorctl, gh, and workflow readiness	endor-agent-kit-setup-agent	read-only	Check Endor Agent Kit readiness for this repository. Do not run scans.

The provider packages expose the same generated workflow set from Agent Kit source recipes. Use the host package README for exact install and invocation syntax.

📦 Distribution Paths

Host	Distribution path	Notes
Claude Code	.claude-plugin/marketplace.json, plugins/claude/endor-labs-agent-kit/, plugins/claude/ai-plugins/	Preferred package plus legacy compatibility.
Codex	.agents/plugins/marketplace.json, plugins/codex/endor-labs-agent-kit/	Skills, custom-agent TOML files, and installer script.
Gemini CLI	plugins/gemini/endor-labs-agent-kit/	Directory install locally; tagged GitHub repo for public installs.
Antigravity CLI	plugins/antigravity/endor-labs-agent-kit/	Package directory with root plugin.json.
Cursor IDE	.cursor-plugin/marketplace.json, plugins/cursor/endor-labs-agent-kit/	Marketplace index plus a self-contained Cursor package.
Cursor SDK	cursor-sdk/	Python SDK launcher, generated prompts, and local/cloud run instructions.
Root support	agents/, skills/, hooks/, runtime/, GEMINI.md	Claude compatibility surfaces plus non-installable Gemini support context.

🔒 Safety Rules

• Setup is readiness guidance; it must not run scans or mutate repositories.
• Setup must not run endorctl host-check.
• Install, update, auth, namespace, and host-specific package steps must be explicit and evidence-backed.
• Do not print, persist, or copy secret values. Report credential presence only by variable or key name.
• Live Endor API evidence requires explicit approval and namespace provenance.
• Mutating workflows split file edits, branch pushes, PR/MR creation, comments, tickets, approval verification, and Endor policy writes into separate gates.

🔁 Source Sync

Do not change generated Agent Kit behavior by editing package files in this repo. Make behavior changes in the Agent Kit source repo, regenerate there, then let the Agent Kit publish workflow open a generated PR here.

Generated sync PRs should include:

• source Agent Kit commit in the PR body
• provenance/agent-kit-catalog.intoto.json
• provenance/manifest.sha256
• validation evidence for root skills, advisory hooks, JSON metadata, Cursor SDK, Gemini no-zip, byte-for-byte generated-surface diffs, and git diff --check

Manual fallback uses the Agent Kit sync script:

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

python3 "$AGENT_KIT_REPO/scripts/sync_ai_plugins_distribution.py" \
  --source "$AGENT_KIT_REPO" \
  --target .

✅ Validation

for skill in skills/* plugins/cursor/endor-labs-agent-kit/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 plugins/cursor/endor-labs-agent-kit/.cursor-plugin/plugin.json >/dev/null
python3 scripts/validate_marketplace_host_boundaries.py --root .
python3 -m json.tool cursor-sdk/agent_definitions.json >/dev/null
python3 -m json.tool hooks/hooks.json >/dev/null
python3 -m json.tool plugins/claude/endor-labs-agent-kit/hooks/hooks.json >/dev/null
python3 -m json.tool plugins/codex/endor-labs-agent-kit/hooks/hooks.json >/dev/null
python3 -m json.tool plugins/gemini/endor-labs-agent-kit/hooks/hooks.json >/dev/null
python3 -m json.tool plugins/antigravity/endor-labs-agent-kit/hooks.json >/dev/null
test ! -e plugins/claude/ai-plugins/hooks
for hook_script in hooks/*.sh plugins/*/*/hooks/*.sh; do bash -n "$hook_script"; done
python3 - <<'PY'
import py_compile

py_compile.compile("cursor-sdk/run_cursor_agent.py", cfile="/tmp/run_cursor_agent.pyc", doraise=True)
PY
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
git diff --check

These checks also run automatically on every pull request via .github/workflows/validate.yml.

Generated drift checks:

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

for host in antigravity claude codex codex-directory gemini; do
  diff -qr "$AGENT_KIT_REPO/plugins/$host" "./plugins/$host"
done
diff -qr "$AGENT_KIT_REPO/cursor-sdk" ./cursor-sdk
diff -q "$AGENT_KIT_REPO/assets/logo.png" assets/logo.png
python3 scripts/validate_marketplace_host_boundaries.py --root .

🗂️ Repository Reference

.agents/plugins/marketplace.json
.claude-plugin/marketplace.json
.cursor-plugin/
agents/
assets/logo.png
cursor-sdk/
docs/
hooks/
GEMINI.md
llms.txt
plugins/
scripts/
skills/

License

This repository includes the existing LICENSE file and Endor Labs plugin metadata for the public distribution packages. Confirm final marketplace, license, and host metadata requirements before public submission.