cross-mod
Hub for building plugins that run in both Claude Code and Google Antigravity (agy) with the Bifrost framework. Use when starting any plugin work in this repository to find the right specialized skill and the end-to-end workflow.
- License 许可
- MIT
- 最近更新
- 2026-10-22
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- cross-mod
- description
- Hub for building plugins that run in both Claude Code and Google Antigravity (agy) with the Bifrost framework. Use when starting any plugin work in this repository to find the right specialized skill and the end-to-end workflow.
03 SKILL.md 正文
Cross-harness plugin hub
A plugin in this repository is written once with Bifrost (@gidragir/bifrost): src/plugin.tsx holds
definePlugin({ panes, commands, claude, config }), state atoms and a React-like UI. bifrost build
produces plugins/<mod>/dist/, the installable plugin for Claude Code (TUI pane, hooks) and
Antigravity (aux-pane webview, skills, rules).
| Skill | Use it for |
|---|---|
bifrost-framework |
definePlugin, atom/useAtom, Host, primitives and components, the CLI |
mod-scaffolding |
pnpm new, the plugin layout, what goes where |
claude-code-mod |
Claude Code engine rules, what the adapter guarantees, raw src/claude.ts |
agy-pane |
The Antigravity adapter: server, page runtime, effects, token, linking |
cross-mod-testing |
Bun tests with the test kit, engine tests, typecheck, lint |
plugin-distribution |
Dev links, release branches, marketplace, publishing the framework |
releasing |
Releasing plugins and the framework: checks, tags, verification, failed runs |
Workflow
pnpm new <mod> "what it does"(or edit an existing plugin).- Pure logic in
src/*.ts(files throughFsLike), Bun tests intest/*.test.ts. - State, panes, commands and Claude events in
src/plugin.tsx; UI from Bifrost components. pnpm dev <mod>andbun testin the plugin folder while editing.- Engine scenarios in
test/engine/*.ts;pnpm check <mod>until build, validate, tsc and tests pass. skills/<mod>/SKILL.mdwith a[Label](sidecar://<mod>/)pill;rules/AGENTS.mdif the plugin needs agent rules.pnpm lint,bun test; live check withpnpm dev:link:desktop/pnpm dev:link:agy.- Bump
versionindefinePlugin,pnpm marketplace, tag<mod>-v<version>.
"agy" is our name for Antigravity (adapter, scripts, docs). Antigravity's own contract keeps
sidecar.json, sidecars/<id>/, window.sidecar, ANTIGRAVITY_SIDECAR_* and sidecar:// pills.
04 同仓库更多 Skills
__MOD_NAME__
__MOD_DESCRIPTION__
ref-pane
Inspect and navigate project artifact references (such as RV-1, FB-2, T-3, ADR-4) in the Auxiliary Pane.
bifrost-dev
Use when changing @gidragir/bifrost itself (packages/bifrost) - adding or renaming an export, Host member, primitive or component, changing codegen or the adapters, bumping its version or releasing it - and not when building a plugin under plugins/<mod>.
bifrost-claude-adapter
Use when changing packages/bifrost/src/claude or src/cli codegen, or when a generated hooks module fails claude plugin validate/test for a reason the framework (not the plugin) causes - scanner errors, missing state contract keys, guard hooks, next(e) chaining.
bifrost-agy-adapter
Use when changing packages/bifrost/src/agy - the generated Antigravity aux-pane server, page runtime client.js, effects, token and preload contract, HTML renderer or bifrost.css - or when an agy pane misbehaves for every plugin rather than one.
releasing
Use when asked to release, publish or tag a plugin or the Bifrost framework in this repository, to bump versions, push release tags (<mod>-v*, framework-v*), or when a Release Plugins / Publish Bifrost Framework run on GitHub failed.