Skip to content

Commit 4c33f17

Browse files
committed
docs: add Antigravity CLI references to documentation files
Match the same documentation coverage as the Copilot harness PR: - ARCHITECTURE.md: add antigravity.py to adapters list, .antigravity/ to generated artifacts, adapter table row, update harness count - CONTRIBUTING.md: add Antigravity CLI to harness list and portability checklist - README.md: add badge, update harness list, table, Pensyve integration - docs/authoring.md: add Antigravity column to model alias table, update harness count and slash-commands note - docs/round-trip-results.md: add summary row, reproduce recipe, update validation command and coverage limits
1 parent 1de2200 commit 4c33f17

5 files changed

Lines changed: 52 additions & 23 deletions

File tree

ARCHITECTURE.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Top-level architectural map for the claude-agents marketplace. Detail lives in [
44

55
## Invariants
66

7-
1. **Single source of truth.** All agent / skill / command authoring happens under `plugins/<name>/`. Generated harness-specific artifacts (`.codex/`, `.cursor-plugin/`, `.opencode/`, `.copilot/`, `commands/`, `agents/`, `skills/` at extension root for Gemini) are produced by adapters and gitignored. Never hand-edit generated files.
7+
1. **Single source of truth.** All agent / skill / command authoring happens under `plugins/<name>/`. Generated harness-specific artifacts (`.codex/`, `.cursor-plugin/`, `.opencode/`, `.copilot/`, `.antigravity/`, `commands/`, `agents/`, `skills/` at extension root for Gemini) are produced by adapters and gitignored. Never hand-edit generated files.
88

99
2. **One canonical context file.** `AGENTS.md` at repo root is the only context file authored directly. `CLAUDE.md` imports it via `@AGENTS.md`. Gemini CLI reads it via `.gemini/settings.json` `context.fileName`. Codex / Cursor / OpenCode read `AGENTS.md` natively.
1010

@@ -36,7 +36,7 @@ claude-agents/
3636
│ ├── adapters/ # Per-harness adapter framework
3737
│ │ ├── base.py # Parser, HarnessAdapter ABC, helpers
3838
│ │ ├── capabilities.py # Capability matrix; consumed by every adapter
39-
│ │ ├── codex.py / cursor.py / opencode.py / gemini.py / copilot.py
39+
│ │ ├── codex.py / cursor.py / opencode.py / gemini.py / copilot.py / antigravity.py
4040
│ │ └── cursor_rules/ # Hand-curated .mdc rules
4141
│ ├── generate.py # Unified CLI: `make generate HARNESS=<x>`
4242
│ ├── validate_generated.py # Structural validation
@@ -62,6 +62,7 @@ Each adapter consumes the canonical `plugins/` source and emits harness-native a
6262
| `cursor.py` | `.cursor-plugin/`, `.cursor/rules/*.mdc` | Marketplace manifests + hand-curated rules. Cursor reads `.claude/` directly for skills/agents |
6363
| `opencode.py` | `.opencode/agents/`, `.opencode/commands/`, `.opencode/skills/` | Permission block from `tools:` allowlist (locked agents preserve intent); strict lowercase tool names; OpenCode-safe skill names |
6464
| `copilot.py` | `.copilot/agents/`, `.copilot/skills/`, `.copilot/commands/` | Markdown agent profiles + SKILL.md skills + commands-as-skills; model maps to GPT-5 family |
65+
| `antigravity.py` | `.antigravity/agents/`, `.antigravity/skills/`, `.antigravity/commands/` | Lowercase agent.json per agent + SKILL.md skills + commands-as-skills; model maps to Gemini 2.5 family |
6566
| `gemini.py` | `skills/`, `agents/`, `commands/*.toml` at extension root | Native skills + April-2026 subagents; `@{path}` injection for large command bodies |
6667

6768
Detail in [`docs/harnesses.md`](docs/harnesses.md) (capability matrix per harness) and [`docs/architecture.md`](docs/architecture.md) (full design rationale).
@@ -84,7 +85,7 @@ Each plugin is a directory under `plugins/`. Three component types, all auto-dis
8485
- **Skills** (`skills/<n>/SKILL.md`) — modular knowledge with progressive disclosure. Frontmatter: `name`, `description` (must include a recognized trigger phrase like "Use when …"). Supporting material in `references/`, templates in `assets/`.
8586
- **Commands** (`commands/<n>.md`) — slash commands. Frontmatter: `description`, `argument-hint`.
8687

87-
Full conventions in [`docs/authoring.md`](docs/authoring.md). Authoring for portability across all five harnesses is the main concern; the adapter framework handles per-harness mechanics.
88+
Full conventions in [`docs/authoring.md`](docs/authoring.md). Authoring for portability across all six harnesses is the main concern; the adapter framework handles per-harness mechanics.
8889

8990
## Model tiers
9091

CONTRIBUTING.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Contributing to claude-agents
22

3-
Thanks for your interest in contributing. This marketplace ships to six agentic
4-
harnesses (Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Gemini CLI, GitHub Copilot) from a single
5-
Markdown source.
3+
Thanks for your interest in contributing. This marketplace is authored for Claude Code
4+
and ships to six downstream harnesses (OpenAI Codex CLI, Cursor, OpenCode, Gemini CLI,
5+
GitHub Copilot, Antigravity CLI) from a single Markdown source.
66

77
## Start here
88

@@ -45,7 +45,7 @@ uv run ty check ../../tools/ src/plugin_eval/
4545

4646
## Cross-harness portability checklist
4747

48-
Your content ships to five harnesses — some have stricter conventions than Claude Code:
48+
Your content ships to six harnesses — some have stricter conventions than Claude Code:
4949

5050
- **Codex** hard-truncates skill bodies at 8 KB. Keep `SKILL.md` short; push detail
5151
into `references/details.md`.
@@ -54,6 +54,8 @@ Your content ships to five harnesses — some have stricter conventions than Cla
5454
- **Cursor** doesn't honor per-agent `tools:` allowlists — use it as a hint only.
5555
- **Copilot** maps Claude model aliases (`opus`/`sonnet`/`haiku`) to the GPT-5 family;
5656
agent `description` must be a plain string.
57+
- **Antigravity CLI** maps Claude model aliases to the Gemini 2.5 family; all tool names
58+
are lowercase; agents use `agent.json` format with Gemini subagent spec.
5759
- All harnesses use ≤150-line context files. Don't bloat `AGENTS.md` / `CLAUDE.md`.
5860

5961
`plugin-eval`'s `harness_portability` dimension catches most of these mechanically;

README.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22

33
> Production-ready agentic workflow building blocks: **83 plugins**, **191 agents**,
44
> **155 skills**, **102 commands** — built for Claude Code and consumed natively by
5-
> OpenAI Codex CLI, Cursor, OpenCode, Gemini CLI, and GitHub Copilot from a single Markdown source.
5+
> OpenAI Codex CLI, Cursor, OpenCode, Gemini CLI, GitHub Copilot, and Antigravity CLI from a single Markdown source.
66
7-
[![Claude Code](https://img.shields.io/badge/Claude%20Code-native-blueviolet)](#claude-code) [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-supported-black)](docs/harnesses.md) [![Cursor](https://img.shields.io/badge/Cursor-supported-purple)](docs/harnesses.md) [![OpenCode](https://img.shields.io/badge/OpenCode-supported-green)](docs/harnesses.md) [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-supported-blue)](GEMINI.md) [![Copilot](https://img.shields.io/badge/Copilot-supported-lightgrey)](docs/harnesses.md)
7+
[![Claude Code](https://img.shields.io/badge/Claude%20Code-native-blueviolet)](#claude-code) [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-supported-black)](docs/harnesses.md) [![Cursor](https://img.shields.io/badge/Cursor-supported-purple)](docs/harnesses.md) [![OpenCode](https://img.shields.io/badge/OpenCode-supported-green)](docs/harnesses.md) [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-supported-blue)](GEMINI.md) [![Copilot](https://img.shields.io/badge/Copilot-supported-lightgrey)](docs/harnesses.md) [![Antigravity CLI](https://img.shields.io/badge/Antigravity%20CLI-supported-orange)](docs/harnesses.md)
88

99
> [!NOTE]
10-
> One source-of-truth (`plugins/`), five harnesses. Each harness gets idiomatic,
10+
> One source-of-truth (`plugins/`), six harnesses. Each harness gets idiomatic,
1111
> harness-native artifacts — not lowest-common-denominator translations.
1212
> See [docs/harnesses.md](docs/harnesses.md) for the capability matrix.
1313
@@ -24,12 +24,12 @@ Pick your harness:
2424

2525
[→ Full Claude Code setup, troubleshooting, and plugin catalog](docs/usage.md)
2626

27-
### Codex CLI · Cursor · OpenCode · Gemini CLI · Copilot
27+
### Codex CLI · Cursor · OpenCode · Gemini CLI · Copilot · Antigravity CLI
2828

2929
```bash
3030
gh repo clone wshobson/agents ~/agents
3131
cd ~/agents
32-
make generate HARNESS=<codex|cursor|opencode|gemini|copilot>
32+
make generate HARNESS=<codex|cursor|opencode|gemini|copilot|antigravity>
3333
```
3434

3535
Setup details and per-harness gotchas: [docs/harnesses.md](docs/harnesses.md). Gemini-specific setup: [GEMINI.md](GEMINI.md) (also auto-loaded by Gemini CLI).
@@ -73,7 +73,7 @@ Three-tier model strategy:
7373

7474
## Multi-harness support
7575

76-
This marketplace ships to five agentic harnesses from one Markdown source. Each adapter
76+
This marketplace ships to six agentic harnesses from one Markdown source. Each adapter
7777
emits harness-native artifacts (not lowest-common-denominator translations):
7878

7979
| Harness | Generates | Notes |
@@ -84,9 +84,10 @@ emits harness-native artifacts (not lowest-common-denominator translations):
8484
| **OpenCode** | `.opencode/agents/`, `.opencode/commands/`, `.opencode/skills/` | `permission:` block from `tools:` allowlist; OpenCode-safe skill names |
8585
| **Gemini CLI** | `skills/`, `agents/`, `commands/` (TOML) | Native skills + subagents (April 2026 spec) |
8686
| **Copilot** | `.copilot/agents/`, `.copilot/skills/`, `.copilot/commands/` | Markdown agent profiles + SKILL.md skills + commands-as-skills; model maps to GPT-5 family |
87+
| **Antigravity CLI** | `.antigravity/agents/`, `.antigravity/skills/`, `.antigravity/commands/` | Lowercase agent.json per agent + SKILL.md skills + commands-as-skills; model maps to Gemini 2.5 family |
8788

8889
```bash
89-
make generate-all # all five
90+
make generate-all # all six
9091
make validate # structural checks
9192
make garden # drift / dead-link / cap detection
9293
```
@@ -141,6 +142,7 @@ integrations for this marketplace's other supported harnesses.
141142
| OpenCode | [integrations/opencode-plugin](https://github.com/major7apps/pensyve/tree/main/integrations/opencode-plugin) |
142143
| Gemini CLI | `gemini extensions install https://github.com/major7apps/pensyve` |
143144
| Copilot | `.copilot/` in repo root or `~/.copilot/` via `make install-copilot` |
145+
| Antigravity CLI | `.antigravity/` in repo root or `~/.antigravity/` via `make install-antigravity` |
144146

145147
## License
146148

docs/authoring.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Authoring portable plugin content
22

3-
Plugin content in this repo ships to **five** harnesses: OpenAI Codex CLI, Cursor, OpenCode, Gemini CLI, and GitHub Copilot. Claude Code is the source-of-truth. The adapter framework handles per-harness
3+
Plugin content in this repo ships to **six** harnesses: OpenAI Codex CLI, Cursor, OpenCode, Gemini CLI, GitHub Copilot, and Antigravity CLI. Claude Code is the source-of-truth. The adapter framework handles per-harness
44
mechanics (frontmatter rewrites, format transforms, output paths) so you author one set of
55
markdown files. But content choices still affect portability — this guide tells you what to
66
do, and what to avoid, so the work you do for Claude Code translates cleanly everywhere.
@@ -105,12 +105,12 @@ clean naming — pick distinct names for skill/command pairs within a plugin.
105105

106106
### Model aliases
107107

108-
| Source field | Codex | Cursor | OpenCode | Gemini | Copilot |
109-
|---|---|---|---|---|---|---|
110-
| `model: opus` | `gpt-5` | `inherit` | `anthropic/claude-opus-4-7` | `gemini-2.5-pro` | `gpt-5` |
111-
| `model: sonnet` | `gpt-5-mini` | `inherit` | `anthropic/claude-sonnet-4-6` | `gemini-2.5-pro` | `gpt-5-mini` |
112-
| `model: haiku` | `gpt-5-nano` | `inherit` | `anthropic/claude-haiku-4-5-20251001` | `gemini-2.5-flash` | `gpt-5-nano` |
113-
| `model: inherit` | `gpt-5` | `inherit` | `anthropic/claude-sonnet-4-6` | `gemini-2.5-pro` | `gpt-5` |
108+
| Source field | Codex | Cursor | OpenCode | Gemini | Copilot | Antigravity CLI |
109+
|---|---|---|---|---|---|---|---|---|
110+
| `model: opus` | `gpt-5` | `inherit` | `anthropic/claude-opus-4-7` | `gemini-2.5-pro` | `gpt-5` | `gemini-2.5-pro` |
111+
| `model: sonnet` | `gpt-5-mini` | `inherit` | `anthropic/claude-sonnet-4-6` | `gemini-2.5-pro` | `gpt-5-mini` | `gemini-2.5-pro` |
112+
| `model: haiku` | `gpt-5-nano` | `inherit` | `anthropic/claude-haiku-4-5-20251001` | `gemini-2.5-flash` | `gpt-5-nano` | `gemini-2.5-flash` |
113+
| `model: inherit` | `gpt-5` | `inherit` | `anthropic/claude-sonnet-4-6` | `gemini-2.5-pro` | `gpt-5` | `gemini-2.5-pro` |
114114

115115
The adapter handles mapping. The `BARE_MODEL_ALIAS` lint is informational — it just notes
116116
that the mapping is implicit. If you want explicit, use `inherit`.
@@ -140,7 +140,7 @@ Things that work in Claude Code but degrade across harnesses:
140140
| Hooks (`hooks:` frontmatter) | Only Claude Code and OpenCode (via TS plugins). |
141141
| `color:` on agents | Cosmetic; dropped everywhere except Claude Code. |
142142
| Per-agent tool allowlist | Honored only on Claude Code/Gemini/OpenCode. Cursor and Codex have coarser models. |
143-
| Slash commands | Codex converts to skills. Gemini transpiles to TOML. Copilot emits `.copilot/commands/` prompt files. |
143+
| Slash commands | Codex converts to skills. Gemini transpiles to TOML. Copilot emits `.copilot/commands/` prompt files. Antigravity emits `.antigravity/commands/` SKILL.md files. |
144144
| Marketplace registry | Only Claude Code and Cursor have one. Gemini installs by URL; Codex/OpenCode have no marketplace. |
145145

146146
When you must use a feature with no equivalent, the `harness_portability` lint won't fire

docs/round-trip-results.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ load the generated artifacts and report what it found.
1414
| **Codex CLI** | 0.133.0 | ✅ pass (structural) | All 191 agent TOMLs parse via Python `tomllib`; AGENTS.md within budget (43 lines / 500 tokens) | Codex doctor surfaces no errors; deeper "did the model actually load the skill" requires interactive verification. |
1515
| **Cursor** | (editor-only) | n/a | n/a | No CLI; manual verification recipe below. |
1616
| **Copilot** | (structural) | ✅ pass | 191 agent profiles, 155 skills, 25 commands all validated | No CLI round-trip tool yet; structural validation via `make validate` passes. |
17+
| **Antigravity CLI** | (structural) | ✅ pass | 191 agent.json profiles, 155 skills, 25 commands all validated | No CLI round-trip tool yet; structural validation via `make validate` passes. |
1718

1819
## Issues surfaced and fixed during round-trip
1920

@@ -100,6 +101,27 @@ make generate HARNESS=cursor
100101
# 6. Skills under .claude/skills/ should auto-trigger from descriptions
101102
```
102103

104+
### Antigravity CLI (no CLI round-trip yet)
105+
106+
```bash
107+
# Generate
108+
make generate HARNESS=antigravity
109+
110+
# Structural validation (parses every generated artifact)
111+
make validate
112+
113+
# Verify artifact tree
114+
ls .antigravity/agents/ # 191 agent.json profiles
115+
ls .antigravity/skills/ # 155 skill dirs (each with SKILL.md)
116+
ls .antigravity/commands/ # 25 command SKILL.md files
117+
118+
# Global install (optional)
119+
make install-antigravity # symlinks .antigravity/ -> ~/.antigravity/
120+
```
121+
122+
Antigravity CLI currently lacks a CLI verification tool. Manual testing requires
123+
opening the Antigravity editor and verifying agents and skills load correctly.
124+
103125
### Copilot (no CLI round-trip yet)
104126

105127
```bash
@@ -128,7 +150,7 @@ The `tools/validate_generated.py` script approximates round-trip without install
128150
harnesses:
129151

130152
```bash
131-
make validate # all five harnesses
153+
make validate # all six harnesses
132154
make validate HARNESS=codex # one only
133155
```
134156

@@ -158,6 +180,8 @@ the artifacts at runtime. Specifically untested by the automated suite:
158180
prompt.
159181
- Whether Copilot's agent profile and skill discovery actually loads our artifacts
160182
end-to-end (no CLI; requires VS Code editor).
183+
- Whether Antigravity CLI's agent.json and skill discovery actually loads our artifacts
184+
end-to-end (no CLI; requires Antigravity editor).
161185

162186
These require interactive use and API-token-burning runs. The recipes above show how
163187
to perform them manually.

0 commit comments

Comments
 (0)