Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions .antigravity-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
{
"name": "browse",
"displayName": "Browserbase",
"version": "0.3.0",
"description": "Give your agent a real browser: navigate, click, type, screenshot, and extract data from any site, locally or on Browserbase cloud browsers.",
"logo": "assets/logo-antigravity.svg",
"suggestedPrompts": [
"Go to Hacker News and get the top 5 stories",
"Open browserbase.com and take a screenshot of the pricing page",
"Find the latest release notes for Stagehand and summarize them"
],
"category": "Developer Tools",
"keywords": [
"browser",
"automation",
"browserbase",
"stagehand",
"web",
"scraping"
],
"author": {
"name": "Browserbase",
"email": "support@browserbase.com",
"url": "https://browserbase.com"
},
"homepage": "https://docs.browserbase.com",
"repository": "https://github.com/browserbase/browse-plugin",
"license": "MIT"
}
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# browse plugin marketplace

Install the [`browse`](https://github.com/browserbase/stagehand/tree/main/packages/cli) CLI as a native plugin in Claude Code, Cursor, Codex, Grok, Muse Code, and Gemini CLI.
Install the [`browse`](https://github.com/browserbase/stagehand/tree/main/packages/cli) CLI as a native plugin in Claude Code, Cursor, Codex, Grok, Muse Code, Gemini CLI, and Google Antigravity.

This repo has no application code. It's a set of static JSON manifests that let each agent marketplace install and SHA-pin the `browse` plugin, plus the skill that teaches the agent to drive `browse` from the shell.

Expand All @@ -15,6 +15,7 @@ This repo has no application code. It's a set of static JSON manifests that let
| `.grok-plugin/plugin.json` | Grok plugin |
| `.muse-plugin/plugin.json` | Muse Code native plugin (uses the `.agents` marketplace above) |
| `gemini-extension.json` | Gemini CLI extension (`GEMINI.md` context file) |
| `.antigravity-plugin/plugin.json` | Google Antigravity marketplace |

See [`docs/add-a-plugin.md`](docs/add-a-plugin.md) for the full repo layout and how to update the plugin.

Expand All @@ -25,6 +26,7 @@ See [`docs/add-a-plugin.md`](docs/add-a-plugin.md) for the full repo layout and
- **Codex / Grok**: add the repo as a plugin marketplace and install `browse`.
- **Muse Code**: install the native plugin from a local checkout or the marketplace. See [Muse Code setup](docs/muse-code.md).
- **Gemini CLI**: install this repo as an extension (`gemini-extension.json` + `GEMINI.md`).
- **Antigravity**: install with `agy plugin install https://github.com/browserbase/browse-plugin`.

Then just ask your agent:

Expand Down
9 changes: 9 additions & 0 deletions assets/logo-antigravity.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 4 additions & 2 deletions docs/add-a-plugin.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,10 +16,12 @@ If Browserbase ever needs a second distinct plugin, it belongs in its own dedica
├── .agents/plugins/marketplace.json # Generic .agents marketplace (path: ".")
├── .grok-plugin/plugin.json # Grok plugin
├── .muse-plugin/plugin.json # Muse Code native plugin (uses .agents marketplace)
├── .antigravity-plugin/plugin.json # Antigravity plugin (discovers skills/ automatically)
├── gemini-extension.json # Gemini CLI extension
├── GEMINI.md # Gemini context file (CLI-only, no mcpServers)
├── plugin.json # Open Plugin spec manifest (vendor-neutral, e.g. `npx plugins add`)
├── assets/logo.svg
├── assets/logo-antigravity.svg # Antigravity logo with transparent padding
├── skills/browse/SKILL.md # YAML frontmatter: name + description
└── scripts/
├── validate-template.mjs # run by CI and locally, see "Validate" below
Expand All @@ -39,15 +41,15 @@ Every per-format `plugin.json`'s `"skills"` and `"logo"` fields are relative to

## Bumping the version

`plugin.json`'s `version` tracks this repo's own release tags (`v0.1.0`, `v0.2.0`, ...), the same as the git tags already used for GitHub Releases. The published Cursor marketplace listing is built by `release.yml`, which only runs on a tag push — merging to `main` alone doesn't update it. `plugin.json` is the single source of truth for the other five: `.claude-plugin/plugin.json`, `.cursor-plugin/plugin.json`, `.grok-plugin/plugin.json`, `.muse-plugin/plugin.json`, and `gemini-extension.json` must all match it exactly.
`plugin.json`'s `version` tracks this repo's own release tags (`v0.1.0`, `v0.2.0`, ...), the same as the git tags already used for GitHub Releases. The published Cursor marketplace listing is built by `release.yml`, which only runs on a tag push — merging to `main` alone doesn't update it. `plugin.json` is the single source of truth for the other six: `.claude-plugin/plugin.json`, `.cursor-plugin/plugin.json`, `.grok-plugin/plugin.json`, `.muse-plugin/plugin.json`, `.antigravity-plugin/plugin.json`, and `gemini-extension.json` must all match it exactly.

To cut a release, bump `plugin.json`'s `version` and run:

```bash
node scripts/sync-version.mjs
```

CI fails if any of the six drift out of sync. Once that PR merges to `main`, a second CI job (`tag-release`, in `.github/workflows/validate.yml`) detects the version change and pushes the matching `vX.Y.Z` tag automatically — no one runs `git tag` by hand. That tag push is what triggers `release.yml` to actually validate, package, and publish the release. If `plugin.json`'s version didn't change on a given push to `main`, or a tag for that version already exists, `tag-release` is a no-op.
CI fails if any of the seven drift out of sync. Once that PR merges to `main`, a second CI job (`tag-release`, in `.github/workflows/validate.yml`) detects the version change and pushes the matching `vX.Y.Z` tag automatically — no one runs `git tag` by hand. That tag push is what triggers `release.yml` to actually validate, package, and publish the release. If `plugin.json`'s version didn't change on a given push to `main`, or a tag for that version already exists, `tag-release` is a no-op.

## Validate

Expand Down
23 changes: 23 additions & 0 deletions scripts/validate-template.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -357,13 +357,36 @@ async function main() {
}
}

await validateAntigravityPlugin();
await validateMusePlugin();
await validateGeminiSync();
await validateVersionSync();

summarizeAndExit();
}

async function validateAntigravityPlugin() {
const manifest = await readJsonFile(
path.join(repoRoot, ".antigravity-plugin", "plugin.json"), "Antigravity plugin manifest"
);
if (!manifest) return;

if (manifest.name !== "browse") {
addError('Antigravity plugin must use name "browse".');
}
for (const field of ["displayName", "description", "logo"]) {
if (typeof manifest[field] !== "string" || !manifest[field].trim()) {
addError(`Antigravity plugin ${field} is required.`);
}
}
if (typeof manifest.logo === "string" && manifest.logo.trim()) {
await validateReferencedPath(repoRoot, "logo", manifest.logo, "Antigravity browse");
}

// Antigravity discovers the shared skill from the conventional skills/ directory.
await validateReferencedPath(repoRoot, "skills", "skills/browse/SKILL.md", "Antigravity browse");
}

async function validateMusePlugin() {
const manifest = await readJsonFile(
path.join(repoRoot, ".muse-plugin", "plugin.json"), "Muse plugin manifest"
Expand Down
1 change: 1 addition & 0 deletions scripts/version-sync.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ import path from "node:path";
export const SOURCE_VERSION_PATH = "plugin.json";

export const VERSION_TARGET_PATHS = [
path.join(".antigravity-plugin", "plugin.json"),
path.join(".claude-plugin", "plugin.json"),
path.join(".cursor-plugin", "plugin.json"),
path.join(".grok-plugin", "plugin.json"),
Expand Down
Loading