Skip to content

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

Add Cursor, Pi/Prime, and Kimi manifests for Beacon Skills

Claude786434aefb07
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
new file mode 100644
index 00000000..7daeaa59
--- /dev/null
+++ b/.cursor-plugin/marketplace.json
@@ -0,0 +1,14 @@
+{
+ "name": "beacon",
+ "owner": {
+ "name": "Asymptote Labs",
+ "url": "https://beacon.sh"
+ },
+ "plugins": [
+ {
+ "name": "beacon",
+ "source": "agent-skills",
+ "description": "Cross-harness memory from Beacon traces: recall reviewed project lessons, distill agent sessions into approved memory, and promote memory to Agent Skills."
+ }
+ ]
+}
diff --git a/CLAUDE.md b/CLAUDE.md
index 9d0a3cd2..ffd96bf3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -13,7 +13,7 @@ Beacon Endpoint Agent is a local-only endpoint telemetry agent for AI runtimes.
- `browser-extension`: optional MV3 collector (Chrome, plus a beta Firefox build target) that relays Claude.ai and ChatGPT chat telemetry into the local pipeline as OTLP.
- `pkg/asymptoteobserve`: shared Go library — event schema, harness-name normalization, provenance markers, token usage, and the threat-rules engine. Imported by the CLI, the hook adapter, and the collector exporter, so a change here reaches all three.
- `plugins`: TypeScript sources for the managed runtime plugins/extensions (`opencode-beacon`, `cline-beacon`, `pi-beacon`, `omp-beacon`, `openclaw-beacon`, `prime-beacon`, `omo-beacon`), each mirrored into an embedded copy under `cli/beacon/internal/endpoint/hooks/assets/`.
-- `agent-skills`: publishable Agent Skills plugin for the traces-to-memory workflow (`beacon-memory-recall`, `beacon-memory-distill`, `beacon-memory-promote`) with manifests for Claude Code, Agent Plugins (Codex, Cursor, Copilot, Kiro), and Gemini CLI; the marketplace entry is the repo-root `.claude-plugin/marketplace.json`. `cli/beacon/cmd/agent_skills_test.go` checks every `beacon` command and flag the skills name against the real command tree, so rename a command and update the skills together.
+- `agent-skills`: publishable Agent Skills plugin for the traces-to-memory workflow (`beacon-memory-recall`, `beacon-memory-distill`, `beacon-memory-promote`) with manifests for Claude Code, Agent Plugins (Codex, Copilot, VS Code, Kiro, Devin), Cursor, Kimi Code, and Gemini CLI. At the repo root, `.claude-plugin/marketplace.json` is read by most harnesses, `.cursor-plugin/marketplace.json` by Cursor, and `package.json` (`pi.skills` only) makes the repo a Pi/Prime Agent package; keep that root `package.json` free of dependencies and scripts. `cli/beacon/cmd/agent_skills_test.go` checks every `beacon` command and flag the skills name against the real command tree, so rename a command and update the skills together.
- `rules` and `spec/threat-rules`: the open rule corpus and the Threat Rules format it conforms to.
- `beacon-sandbox`: harness that runs a real Claude Code session in a disposable sandbox and checks what Beacon captured. See `beacon-sandbox/AGENTS.md`.
- `packaging`: macOS, Linux, and Windows packaging and deployment assets.
diff --git a/README.md b/README.md
index 7905b22a..33c451af 100644
--- a/README.md
+++ b/README.md
@@ -243,35 +243,39 @@ Beacon supports local agents, browser agents, cloud agents, CI workflows, and ag
| Cline | Plugin + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ `.cline/skills` |
| Codex CLI | OTLP + hooks + poll | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ | ✅ Plugin |
| Codex Desktop | OTLP | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ | ✅ Plugin |
-| Cursor | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ skills CLI |
+| Cursor | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ Plugin |
| DeepSeek Harness | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ `.agents/skills` |
-| Devin CLI | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ skills CLI |
+| Devin CLI | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ Plugin |
| Devin Desktop | Hooks | – | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ via Devin CLI |
| Factory Droid | OTLP + hooks + poll | ✅ | ✅ | ✅ | – | ✅ | ✅ | – | – | ✅ Plugin |
| fx (Vercel Labs) | Poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ `/skills install` |
-| Gemini CLI | OTLP | – | ✅ | ✅ | – | ✅ | ✅ | ✅ | – | ✅ skills CLI |
+| Gemini CLI | OTLP | – | ✅ | ✅ | – | ✅ | ✅ | ✅ | – | ✅ `gemini skills install` |
| GitHub Copilot CLI | OTLP + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ Plugin |
| goose | Adapter only; manual hooks/OTLP | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ skills CLI |
-| Grok Build | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ skills CLI |
-| Hermes Agent | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ skills CLI |
-| Kimi Code | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ skills CLI |
-| Kiro | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ skills CLI |
+| Grok Build | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ Plugin |
+| Hermes Agent | Hooks + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ `hermes skills install` |
+| Kimi Code | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ Plugin |
+| Kiro | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ Power |
| Muse Code | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ `.agents/skills` |
-| Oh My Pi | Extension | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ `.agents/skills` |
-| OpenClaw Gateway | Plugin + OTLP + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ~ | ✅ skills CLI |
+| Oh My Pi | Extension | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ Plugin |
+| OpenClaw Gateway | Plugin + OTLP + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ~ | ✅ Plugin |
| OpenCode | Plugin + poll | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ skills CLI |
| OpenHands | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | – | ✅ skills CLI |
-| Pi | Extension + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ skills CLI |
-| Prime Agent | Extension + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ | ✅ `.agents/skills` |
-| Qwen Code | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ skills CLI |
+| Pi | Extension + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | ✅ | ✅ | ✅ Package |
+| Prime Agent | Extension + poll | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ | ✅ Package |
+| Qwen Code | Hooks | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ Plugin |
| Senpi | Extension | ✅ | ✅ | ✅ | ✅ | ✅ | – | – | ✅ | ✅ `.agents/skills` |
| VS Code | OTLP + hooks | ✅ | ✅ | ✅ | ~ | ~ | – | ~ | – | ✅ Plugin |
**Skills** shows how to install [Beacon Skills](https://docs.beacon.sh/concepts/beacon-skills), the Agent Skills that recall and distill project memory from these traces. Every runtime above loads Agent Skills:
-- **Plugin**: add the Beacon marketplace, for example `/plugin marketplace add asymptote-labs/agent-beacon` in Claude Code or `codex plugin marketplace add asymptote-labs/agent-beacon`. Claude Cowork adds it under Customize → Plugins, and VS Code through `chat.plugins.marketplaces`.
+- **Plugin**: install the `beacon` plugin from this repository's marketplace, for example `/plugin marketplace add asymptote-labs/agent-beacon` in Claude Code.
+- **Package** (Pi, Prime Agent): `pi install git:github.com/asymptote-labs/agent-beacon`.
+- **Power** (Kiro): import `https://github.com/asymptote-labs/agent-beacon/tree/main/agent-skills` from the Powers panel.
- **skills CLI**: `npx skills add asymptote-labs/agent-beacon`, optionally with `-a <agent>`.
-- **A directory**: copy `agent-skills/skills/*` from this repository into that project directory. fx installs with `/skills install asymptote-labs/agent-beacon`, and Devin Desktop syncs skills installed through Devin CLI.
+- **A directory**: copy `agent-skills/skills/*` into that project directory.
+
+The [Beacon Skills page](https://docs.beacon.sh/concepts/beacon-skills#install) has the exact command for each runtime.
### Browser Chat
diff --git a/agent-skills/.cursor-plugin/plugin.json b/agent-skills/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..86d8b7c9
--- /dev/null
+++ b/agent-skills/.cursor-plugin/plugin.json
@@ -0,0 +1,13 @@
+{
+ "name": "beacon",
+ "version": "0.1.0",
+ "description": "Cross-harness memory from Beacon traces: recall reviewed project lessons, distill agent sessions into approved memory, and promote memory to Agent Skills.",
+ "author": {
+ "name": "Asymptote Labs",
+ "url": "https://beacon.sh"
+ },
+ "homepage": "https://docs.beacon.sh/concepts/beacon-skills",
+ "repository": "https://github.com/asymptote-labs/agent-beacon",
+ "license": "MIT",
+ "keywords": ["memory", "traces", "observability", "agent-skills", "beacon", "mcp"]
+}
diff --git a/agent-skills/README.md b/agent-skills/README.md
index 1cd197ff..53ede335 100644
--- a/agent-skills/README.md
+++ b/agent-skills/README.md
@@ -15,15 +15,33 @@ harnesses that take MCP servers from plugins.
## Install
-| Harness | Command |
+| Runtime | Install |
|---------|---------|
| Claude Code | `/plugin marketplace add asymptote-labs/agent-beacon`, then `/plugin install beacon@beacon` |
-| Codex | `codex plugin marketplace add asymptote-labs/agent-beacon` |
+| Claude Cowork | Customize → Plugins → Add marketplace, then enter `asymptote-labs/agent-beacon` |
+| Codex (CLI and desktop) | `codex plugin marketplace add asymptote-labs/agent-beacon`, then `codex plugin add beacon@beacon` |
| GitHub Copilot CLI | `copilot plugin marketplace add asymptote-labs/agent-beacon`, then `copilot plugin install beacon@beacon` |
+| VS Code | Add `asymptote-labs/agent-beacon` to the `chat.plugins.marketplaces` setting, then install `beacon` |
+| Cursor | An admin imports `https://github.com/asymptote-labs/agent-beacon` under Settings → Plugins → Team Marketplaces; users install `beacon` from Customize |
| Factory Droid | `droid plugin marketplace add asymptote-labs/agent-beacon`, then `droid plugin install beacon@beacon` |
-| Gemini CLI | `npx skills add asymptote-labs/agent-beacon -a gemini-cli` (see the note below) |
-| Any skills-capable agent (Cursor, OpenCode, goose, Kiro, Pi, Hermes Agent, …) | `npx skills add asymptote-labs/agent-beacon` |
-| Cline | Copy `skills/*` into `.cline/skills` |
+| Grok Build | `grok plugin marketplace add asymptote-labs/agent-beacon`, then `grok plugin install beacon` |
+| Devin CLI | `devin plugins install asymptote-labs/agent-beacon#agent-skills` |
+| Qwen Code | `qwen extensions install asymptote-labs/agent-beacon:beacon` |
+| Oh My Pi | `omp plugin marketplace add asymptote-labs/agent-beacon`, then `omp plugin install beacon@beacon` |
+| OpenClaw | `openclaw plugins install beacon --marketplace asymptote-labs/agent-beacon` |
+| Kimi Code | From a clone: `/plugins install ./agent-beacon/agent-skills` |
+| Kiro | Powers → Add Custom Power → Import power from GitHub, then enter `https://github.com/asymptote-labs/agent-beacon/tree/main/agent-skills` |
+| Pi | `pi install git:github.com/asymptote-labs/agent-beacon` |
+| Prime Agent | `prime-agent package install git:github.com/asymptote-labs/agent-beacon` |
+| Gemini CLI | `gemini skills install https://github.com/asymptote-labs/agent-beacon.git --path agent-skills/skills` |
+| Hermes Agent | `hermes skills install asymptote-labs/agent-beacon/agent-skills/skills/<skill>` for each skill |
+| Antigravity CLI, goose, OpenCode, OpenHands, and other skills-capable agents | `npx skills add asymptote-labs/agent-beacon`, optionally with `-a <agent>` |
+| Cline | Copy `agent-skills/skills/*` into `.cline/skills` |
+| DeepSeek Harness, Muse Code, Senpi | Copy `agent-skills/skills/*` into `.agents/skills` |
+| fx | `/skills install asymptote-labs/agent-beacon` |
+
+The plugin routes also register the local Beacon MCP server. Package, power, and skills
+routes install the skills only; the recall skill then falls back to `beacon memory list`.
## Layout
@@ -31,15 +49,20 @@ This directory is a self-contained plugin root. Every harness reads the same `sk
```text
agent-skills/
- plugin.json Agent Plugins 1.0 manifest (Codex, Cursor, Copilot, VS Code, Kiro)
+ plugin.json Agent Plugins 1.0 manifest (Codex, Copilot, VS Code, Kiro, Devin)
mcp.json Agent Plugins MCP config
- .claude-plugin/plugin.json Claude Code (also read by Factory Droid)
+ .claude-plugin/plugin.json Claude Code (also read by Droid, Devin, OpenClaw, Qwen)
.mcp.json Claude Code MCP config
+ .cursor-plugin/plugin.json Cursor
+ kimi.plugin.json Kimi Code
gemini-extension.json Gemini CLI extension manifest
skills/<name>/SKILL.md agentskills.io format, shared by all
../.claude-plugin/marketplace.json
Marketplace entry, read by Claude Code, Codex, Copilot,
- Factory Droid, and the skills CLI
+ Droid, Grok, Qwen, Oh My Pi, OpenClaw, and the skills CLI
+../.cursor-plugin/marketplace.json
+ Cursor's marketplace entry
+../package.json Pi and Prime Agent package manifest (pi.skills)
```
`cli/beacon/cmd/agent_skills_test.go` fails when a skill names a `beacon` command or flag
@@ -48,8 +71,9 @@ disagree on name or version.
## Releasing a new version
-1. Bump `version` in `plugin.json`, `.claude-plugin/plugin.json`, `gemini-extension.json`,
- the marketplace entry, and each skill's `metadata.version`. The Go test enforces this.
+1. Bump `version` in `plugin.json`, `.claude-plugin/plugin.json`, `.cursor-plugin/plugin.json`,
+ `gemini-extension.json`, `kimi.plugin.json`, the Claude marketplace entry, and each
+ skill's `metadata.version`. The Go test enforces this.
2. Run `go test ./cmd -run AgentSkills` in `cli/beacon`, and `claude plugin validate --strict agent-skills`.
3. Merge to `main`. Marketplaces that track the repository pick up the change. Listings
that pin a commit (the Claude community marketplace) need that commit updated.
diff --git a/agent-skills/kimi.plugin.json b/agent-skills/kimi.plugin.json
new file mode 100644
index 00000000..534d17d8
--- /dev/null
+++ b/agent-skills/kimi.plugin.json
@@ -0,0 +1,15 @@
+{
+ "name": "beacon",
+ "version": "0.1.0",
+ "description": "Cross-harness memory from Beacon traces: recall reviewed project lessons, distill agent sessions into approved memory, and promote memory to Agent Skills.",
+ "skills": "./skills/",
+ "mcpServers": {
+ "beacon": {
+ "command": "beacon",
+ "args": ["mcp", "serve"]
+ }
+ },
+ "interface": {
+ "displayName": "Beacon memory"
+ }
+}
diff --git a/cli/beacon/cmd/agent_skills_test.go b/cli/beacon/cmd/agent_skills_test.go
index f911bc85..5f874fcf 100644
--- a/cli/beacon/cmd/agent_skills_test.go
+++ b/cli/beacon/cmd/agent_skills_test.go
@@ -114,35 +114,64 @@ func TestAgentSkillsManifestsAgree(t *testing.T) {
return m
}
want := read("plugin.json")
- for _, rel := range []string{".claude-plugin/plugin.json", "gemini-extension.json"} {
+ for _, rel := range []string{".claude-plugin/plugin.json", ".cursor-plugin/plugin.json", "gemini-extension.json", "kimi.plugin.json"} {
if got := read(rel); got != want {
t.Errorf("%s = %+v, want %+v (same as plugin.json)", rel, got, want)
}
}
- data, err := os.ReadFile(filepath.Join(agentSkillsDir, "..", ".claude-plugin", "marketplace.json"))
+ // Claude Code's marketplace is also read by Codex, Copilot, Droid, Grok, Qwen,
+ // Oh My Pi, and OpenClaw. Cursor reads only its own, which names the source
+ // without "./" and takes the version from the plugin manifest.
+ for _, market := range []struct {
+ rel, source string
+ requireVersion bool
+ }{
+ {".claude-plugin/marketplace.json", "./agent-skills", true},
+ {".cursor-plugin/marketplace.json", "agent-skills", false},
+ } {
+ data, err := os.ReadFile(filepath.Join(agentSkillsDir, "..", market.rel))
+ if err != nil {
+ t.Fatal(err)
+ }
+ var marketplace struct {
+ Plugins []struct {
+ manifest
+ Source string `json:"source"`
+ } `json:"plugins"`
+ }
+ if err := json.Unmarshal(data, &marketplace); err != nil {
+ t.Fatalf("%s: %v", market.rel, err)
+ }
+ found := false
+ for _, p := range marketplace.Plugins {
+ if p.Source != market.source {
+ continue
+ }
+ found = true
+ if p.Name != want.Name || (market.requireVersion && p.Version != want.Version) || (!market.requireVersion && p.Version != "" && p.Version != want.Version) {
+ t.Errorf("%s entry = %+v, want %+v", market.rel, p.manifest, want)
+ }
+ }
+ if !found {
+ t.Errorf("%s has no entry for %s", market.rel, market.source)
+ }
+ }
+ // Pi and Prime Agent install the whole repository, so the root package.json
+ // points them at the skills directory.
+ data, err := os.ReadFile(filepath.Join(agentSkillsDir, "..", "package.json"))
if err != nil {
t.Fatal(err)
}
- var marketplace struct {
- Plugins []struct {
- manifest
- Source string `json:"source"`
- } `json:"plugins"`
+ var pkg struct {
+ Pi struct {
+ Skills []string `json:"skills"`
+ } `json:"pi"`
}
- if err := json.Unmarshal(data, &marketplace); err != nil {
+ if err := json.Unmarshal(data, &pkg); err != nil {
t.Fatal(err)
}
- found := false
- for _, p := range marketplace.Plugins {
- if p.Source == "./agent-skills" {
- found = true
- if p.manifest != want {
- t.Errorf("marketplace entry = %+v, want %+v", p.manifest, want)
- }
- }
- }
- if !found {
- t.Error("marketplace.json has no entry for ./agent-skills")
+ if len(pkg.Pi.Skills) != 1 || filepath.Clean(pkg.Pi.Skills[0]) != "agent-skills/skills" {
+ t.Errorf("package.json pi.skills = %v, want [./agent-skills/skills]", pkg.Pi.Skills)
}
for _, path := range agentSkillFiles(t) {
data, err := os.ReadFile(path)
diff --git a/docs/concepts/beacon-skills.mdx b/docs/concepts/beacon-skills.mdx
index 4cb31765..3da6b3cd 100644
--- a/docs/concepts/beacon-skills.mdx
+++ b/docs/concepts/beacon-skills.mdx
@@ -36,52 +36,40 @@ that accept MCP servers from plugins. When the server is available, recall uses
## Install
-<Tabs>
- <Tab title="Claude Code">
- ```bash
- /plugin marketplace add asymptote-labs/agent-beacon
- /plugin install beacon@beacon
- ```
-
- The skills appear as `/beacon:beacon-memory-recall`, `/beacon:beacon-memory-distill`,
- and `/beacon:beacon-memory-promote`, and Claude also loads them when a task matches.
- </Tab>
- <Tab title="Codex">
- ```bash
- codex plugin marketplace add asymptote-labs/agent-beacon
- ```
-
- Then install the `beacon` plugin from the marketplace.
- </Tab>
- <Tab title="GitHub Copilot CLI">
- ```bash
- copilot plugin marketplace add asymptote-labs/agent-beacon
- copilot plugin install beacon@beacon
- ```
- </Tab>
- <Tab title="Factory Droid">
- ```bash
- droid plugin marketplace add asymptote-labs/agent-beacon
- droid plugin install beacon@beacon
- ```
- </Tab>
- <Tab title="Other agents">
- For Cursor, Gemini CLI, OpenCode, goose, Kiro, Pi, Hermes Agent, and any other agent
- that reads Agent Skills, use the skills CLI:
-
- ```bash
- npx skills add asymptote-labs/agent-beacon
- ```
-
- Pass `-a <agent>` to target one agent, for example `-a gemini-cli` or `-a cursor`,
- and `--skill <name>` to install a single skill.
-
- Cline reads `.cline/skills` rather than `.agents/skills`, so copy the skills there
- from [`agent-skills/skills`](https://github.com/asymptote-labs/agent-beacon/tree/main/agent-skills/skills).
- The [README](https://github.com/asymptote-labs/agent-beacon#local-agent-coverage)
- lists the install route for every supported runtime.
- </Tab>
-</Tabs>
+Beacon Skills install from the `asymptote-labs/agent-beacon` repository. Most harnesses
+read its plugin marketplace directly:
+
+| Runtime | Install |
+|---------|---------|
+| Claude Code | `/plugin marketplace add asymptote-labs/agent-beacon`, then `/plugin install beacon@beacon` |
+| Claude Cowork | Customize → Plugins → Add marketplace, then enter `asymptote-labs/agent-beacon` |
+| Codex (CLI and desktop) | `codex plugin marketplace add asymptote-labs/agent-beacon`, then `codex plugin add beacon@beacon` |
+| GitHub Copilot CLI | `copilot plugin marketplace add asymptote-labs/agent-beacon`, then `copilot plugin install beacon@beacon` |
+| VS Code | Add `asymptote-labs/agent-beacon` to the `chat.plugins.marketplaces` setting, then install `beacon` |
+| Cursor | An admin imports `https://github.com/asymptote-labs/agent-beacon` under Settings → Plugins → Team Marketplaces; users install `beacon` from Customize |
+| Factory Droid | `droid plugin marketplace add asymptote-labs/agent-beacon`, then `droid plugin install beacon@beacon` |
+| Grok Build | `grok plugin marketplace add asymptote-labs/agent-beacon`, then `grok plugin install beacon` |
+| Devin CLI | `devin plugins install asymptote-labs/agent-beacon#agent-skills` |
+| Qwen Code | `qwen extensions install asymptote-labs/agent-beacon:beacon` |
+| Oh My Pi | `omp plugin marketplace add asymptote-labs/agent-beacon`, then `omp plugin install beacon@beacon` |
+| OpenClaw | `openclaw plugins install beacon --marketplace asymptote-labs/agent-beacon` |
+| Kimi Code | From a clone: `/plugins install ./agent-beacon/agent-skills` |
+| Kiro | Powers → Add Custom Power → Import power from GitHub, then enter `https://github.com/asymptote-labs/agent-beacon/tree/main/agent-skills` |
+| Pi | `pi install git:github.com/asymptote-labs/agent-beacon` |
+| Prime Agent | `prime-agent package install git:github.com/asymptote-labs/agent-beacon` |
+| Gemini CLI | `gemini skills install https://github.com/asymptote-labs/agent-beacon.git --path agent-skills/skills` |
+| Hermes Agent | `hermes skills install asymptote-labs/agent-beacon/agent-skills/skills/<skill>` for each skill |
+| Antigravity CLI, goose, OpenCode, OpenHands, and other skills-capable agents | `npx skills add asymptote-labs/agent-beacon`, optionally with `-a <agent>` |
+| Cline | Copy `agent-skills/skills/*` into `.cline/skills` |
+| DeepSeek Harness, Muse Code, Senpi | Copy `agent-skills/skills/*` into `.agents/skills` |
+| fx | `/skills install asymptote-labs/agent-beacon` |
+
+Plugin installs also register Beacon's local MCP server. Package, power, and skills
+installs add the skills only, and recall falls back to `beacon memory list`.
+
+In Claude Code the skills appear as `/beacon:beacon-memory-recall`,
+`/beacon:beacon-memory-distill`, and `/beacon:beacon-memory-promote`. Every harness also
+loads them on its own when a request matches.
## Using the skills
@@ -160,8 +148,11 @@ flag.
The skills live in [`agent-skills/`](https://github.com/asymptote-labs/agent-beacon/tree/main/agent-skills)
in the Beacon repository. One `skills/` directory serves every harness through its own
manifest: `.claude-plugin/plugin.json` for Claude Code, an Agent Plugins `plugin.json`
-for Codex, Cursor, Copilot, and Kiro, and `gemini-extension.json` for Gemini CLI. The
-repository's root `.claude-plugin/marketplace.json` is the marketplace entry.
+for Codex, Copilot, VS Code, Kiro, and Devin, `.cursor-plugin/plugin.json` for Cursor,
+`kimi.plugin.json` for Kimi Code, and `gemini-extension.json` for Gemini CLI. At the
+repository root, `.claude-plugin/marketplace.json` is the marketplace most harnesses read,
+`.cursor-plugin/marketplace.json` is Cursor's, and `package.json` makes the repository a
+Pi and Prime Agent package.
A test in the CLI checks every `beacon` command and flag the skills mention, so a change
that renames one fails the same pull request.
diff --git a/package.json b/package.json
new file mode 100644
index 00000000..f2a9f1db
--- /dev/null
+++ b/package.json
@@ -0,0 +1,10 @@
+{
+ "name": "agent-beacon",
+ "private": true,
+ "description": "Pi and Prime Agent package manifest for Beacon Skills. The Beacon CLI, SDK, extension, and plugins keep their own package.json files.",
+ "license": "MIT",
+ "keywords": ["pi-package"],
+ "pi": {
+ "skills": ["./agent-skills/skills"]
+ }
+}