mirror of https://github.com/wshobson/agents synced 2026-06-21 14:13:58 +00:00

Files

T

Seth Hobson 608c3840ca feat: native plugin-install for Codex/Cursor/Gemini + CLAUDE.md→AGENTS.md symlink

Add lean, native plugin-install entry points so each harness's own plugin
manager can install this marketplace (mirroring obra/superpowers) — committing
only small JSON registries, not duplicated skill/agent content trees.

- Codex: committed marketplace registry (.agents/plugins/marketplace.json) +
  per-plugin manifests (plugins/*/.codex-plugin/plugin.json). Entries point at
  source ./plugins/<name>; Codex reads SKILL.md directly. Transformed
  .codex/skills|agents stay gitignored.
- Cursor: commit the existing .cursor-plugin/ marketplace + .cursor/rules/
  (these already point at source plugins/).
- Gemini: gemini-extension.json already committed (contextFileName: AGENTS.md);
  transformed trees stay gitignored (install via clone + make generate).
- OpenCode: unchanged — install via `make install-opencode` (transformed tree
  stays gitignored).
- CLAUDE.md is now a symlink to AGENTS.md; Claude-Code addenda moved to
  docs/harnesses.md.
- CI: new step fails if `make generate-all` drifts from the committed registries.

Net new committed: ~720 KB of manifests (no skill/agent duplication). Adds
round-trip tests for the new registries + the symlink. Docs updated across
README, docs/harnesses.md, ARCHITECTURE.md, CONTRIBUTING.md, GEMINI.md,
docs/authoring.md, and the PR template.

2026-05-29 13:02:40 -04:00

2.0 KiB

Raw Blame History

Gemini CLI — setup guide

The canonical context file is AGENTS.md at the repo root. Gemini CLI reads it via .gemini/settings.json (context.fileName). This guide covers Gemini-specific setup only.

Install

gemini extensions install https://github.com/wshobson/agents
cd ~/.gemini/extensions/claude-code-workflows
make generate HARNESS=gemini
# restart Gemini CLI

What you get

155 skills at skills/<plugin>__<skill>/SKILL.md — described in AGENTS.md. Describe a task to activate.
191 subagents at agents/<plugin>__<agent>.md — invoke with @<agent>.
102 slash commands at /<plugin>:<command> — use /help to list.

Companion Memory Extension

Pensyve is maintained upstream as a separate Gemini CLI extension with MCP-backed memory and context injection:

gemini extensions install https://github.com/major7apps/pensyve

Gemini-specific differences

Capability	Claude Code	Gemini CLI
Plugin installation	`/plugin install`	`gemini extensions install <url>`
Context file	reads `CLAUDE.md` (a symlink to `AGENTS.md`)	reads via `.gemini/settings.json` redirect to AGENTS.md
Per-agent tool allowlist	`tools:` (always)	`tools:` (honored — remapped to Gemini-native names)
Skill / agent discovery	native	native (skills/, agents/ at extension root)
Model assignment	per-agent	session-level (override via `model:` frontmatter)
`TodoWrite` tool	yes	no equivalent

Regenerating

make generate HARNESS=gemini                            # all plugins
make generate HARNESS=gemini PLUGIN=javascript-typescript   # one plugin
make clean-generated HARNESS=gemini                     # remove output

2.0 KiB Raw Blame History