Skip to content
Open
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
5 changes: 5 additions & 0 deletions .changeset/agy-provider.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@rivus/agent-kit": minor
---

Add Antigravity CLI: identity, discovery (the `agy` binary, `ANTIGRAVITY_GEMINI_DIR` home override and Google API-key variables), and an ACP launch profile for `agy acp`. Hooks, sessions and usage stay unsupported: the CLI documents no `hooks.json` schema and stores conversations as protobuf payloads.
29 changes: 15 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,20 +87,21 @@ Hook events, harness installation, usage records, cost, Effect and ACP each have
[`@rivus/agent-kit-collab` reference](packages/agent-kit-collab/README.md).

## Built-in support
| Agent | identity | discovery | hooks | install | sessions | usage | acp |
| ----------- | -------- | --------- | -------------------------- | ---------------------------------- | ---------------------------------------- | --------------------------------------- | --------------------------- |
| claude-code | yes | yes | yes | yes | yes | yes | yes |
| codex | yes | yes | yes | yes | yes | yes | yes |
| cursor | yes | yes | yes | yes | Session storage has no supported reader. | Usage storage has no supported decoder. | No supported ACP transport. |
| dim | yes | yes | yes | yes | yes | yes | yes |
| dsh | yes | yes | No supported hook dialect. | No supported installation adapter. | yes | yes | yes |
| gemini-cli | yes | yes | yes | yes | yes | yes | yes |
| grok | yes | yes | yes | yes | yes | yes | yes |
| kimi | yes | yes | yes | yes | yes | yes | yes |
| opencode | yes | yes | yes | yes | yes | yes | yes |
| pi | yes | yes | yes | yes | yes | yes | yes |
| qoder | yes | yes | yes | yes | The session store is not captured yet. | The session store is not captured yet. | yes |
| zcode | yes | yes | yes | yes | yes | yes | No supported ACP transport. |
| Agent | identity | discovery | hooks | install | sessions | usage | acp |
| ----------- | -------- | --------- | ---------------------------------------- | ------------------------------------- | --------------------------------------------------------------- | -------------------------------------------------- | --------------------------- |
| agy | yes | yes | The hooks.json schema is not documented. | No supported hook dialect to install. | Conversations are protobuf payloads without a published schema. | Usage lives in the protobuf conversation payloads. | yes |
| claude-code | yes | yes | yes | yes | yes | yes | yes |
| codex | yes | yes | yes | yes | yes | yes | yes |
| cursor | yes | yes | yes | yes | Session storage has no supported reader. | Usage storage has no supported decoder. | No supported ACP transport. |
| dim | yes | yes | yes | yes | yes | yes | yes |
| dsh | yes | yes | No supported hook dialect. | No supported installation adapter. | yes | yes | yes |
| gemini-cli | yes | yes | yes | yes | yes | yes | yes |
| grok | yes | yes | yes | yes | yes | yes | yes |
| kimi | yes | yes | yes | yes | yes | yes | yes |
| opencode | yes | yes | yes | yes | yes | yes | yes |
| pi | yes | yes | yes | yes | yes | yes | yes |
| qoder | yes | yes | yes | yes | The session store is not captured yet. | The session store is not captured yet. | yes |
| zcode | yes | yes | yes | yes | yes | yes | No supported ACP transport. |

## Entries

Expand Down
12 changes: 8 additions & 4 deletions apps/website/content/docs/en/agents.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,17 +21,21 @@ The README's support table uses these words where a cell is not "yes":
- DeepSeek Harness hooks: no supported hook dialect.
- DeepSeek Harness install: no supported installation adapter.
- ZCode ACP: no supported ACP transport.
- Antigravity CLI hooks: the hooks.json schema is not documented.
- Antigravity CLI install: no supported hook dialect to install.
- Antigravity CLI sessions: conversations are protobuf payloads without a published schema.
- Antigravity CLI usage: usage lives in the protobuf conversation payloads.

## Homes and names

Every Agent in the table except DeepSeek Harness has a hook dialect in `/harness/events`.
Every Agent in the table except DeepSeek Harness and Antigravity CLI has a hook dialect in `/harness/events`.

`/transcript/usage` reads the usage of every Agent in the table except Cursor and Qoder CLI; DimCode needs `platform.sqlite`.
`/transcript/usage` reads the usage of every Agent in the table except Cursor, Qoder CLI and Antigravity CLI; DimCode needs `platform.sqlite`.

`/transcript/usage` reads the usage of every Agent in the table except Cursor and Qoder CLI.
`/transcript/usage` reads the usage of every Agent in the table except Cursor, Qoder CLI and Antigravity CLI.

`builtinProviders` has an identity for each of them, and a home rule for each one except Cursor. Cursor's home cell is `none`: `CURSOR_CONFIG_DIR`, `$XDG_CONFIG_HOME/cursor`, `~/.cursor`. Discovery says `CURSOR_CONFIG_DIR` and `XDG_CONFIG_HOME` remain unsupported. See [Agent detection](/docs/connection/discovery).

Codex's default home includes archived sessions. `GEMINI_CLI_HOME` replaces the user's home. `PI_CODING_AGENT_DIR` expands `~`. opencode's home in this table is the data home (`$XDG_DATA_HOME/opencode`, otherwise `~/.local/share/opencode`), not the plugin/config home.
Codex's default home includes archived sessions. `GEMINI_CLI_HOME` replaces the user's home. `PI_CODING_AGENT_DIR` expands `~`. opencode's home in this table is the data home (`$XDG_DATA_HOME/opencode`, otherwise `~/.local/share/opencode`), not the plugin/config home. Antigravity CLI shares the Gemini directory: `ANTIGRAVITY_GEMINI_DIR` names the `.gemini` directory itself, and the CLI's own state sits in `~/.gemini/antigravity-cli`.

To display an Agent name, find `builtinProviders.find((provider) => provider.id === id)?.identity?.displayName`. Adding a provider is [Providers](/docs/concepts/providers).
12 changes: 8 additions & 4 deletions apps/website/content/docs/zh/agents.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,17 +21,21 @@ README 的支持表在单元格不是「是」时使用这些说法:
- DeepSeek Harness 的 hook:没有受支持的 hook 方言。
- DeepSeek Harness 的安装:没有受支持的安装适配器。
- ZCode 的 ACP:没有受支持的 ACP 传输。
- Antigravity CLI 的 hook:hooks.json 的格式没有文档。
- Antigravity CLI 的安装:没有可安装的受支持 hook 方言。
- Antigravity CLI 的会话:会话是无公开格式的 protobuf 载荷。
- Antigravity CLI 的用量:用量在 protobuf 会话载荷里。

## 主目录与名称

表里除 DeepSeek Harness 外,每个 Agent 在 `/harness/events` 里都有 hook 方言。
表里除 DeepSeek Harness 和 Antigravity CLI 外,每个 Agent 在 `/harness/events` 里都有 hook 方言。

`/transcript/usage` 读取表里除 Cursor 和 Qoder CLI 以外每个 Agent 的用量;DimCode 需要 `platform.sqlite`。
`/transcript/usage` 读取表里除 Cursor、Qoder CLI 和 Antigravity CLI 以外每个 Agent 的用量;DimCode 需要 `platform.sqlite`。

`/transcript/usage` 读取表里除 Cursor 和 Qoder CLI 以外每个 Agent 的用量。
`/transcript/usage` 读取表里除 Cursor、Qoder CLI 和 Antigravity CLI 以外每个 Agent 的用量。

`builtinProviders` 为表里的每个 Agent 提供 identity。除 Cursor 外,每个 Agent 还有主目录规则。Cursor 的主目录单元格是 `none`:`CURSOR_CONFIG_DIR`、`$XDG_CONFIG_HOME/cursor`、`~/.cursor`。发现说明 `CURSOR_CONFIG_DIR` 和 `XDG_CONFIG_HOME` 仍然不受支持。见 [Agent 检测](/docs/connection/discovery)。

Codex 的默认主目录包含已归档会话。`GEMINI_CLI_HOME` 替换的是用户主目录。`PI_CODING_AGENT_DIR` 会展开 `~`。表里 opencode 的主目录是数据目录(`$XDG_DATA_HOME/opencode`,否则是 `~/.local/share/opencode`),不是插件目录,也不是配置目录。
Codex 的默认主目录包含已归档会话。`GEMINI_CLI_HOME` 替换的是用户主目录。`PI_CODING_AGENT_DIR` 会展开 `~`。表里 opencode 的主目录是数据目录(`$XDG_DATA_HOME/opencode`,否则是 `~/.local/share/opencode`),不是插件目录,也不是配置目录。Antigravity CLI 与 Gemini CLI 共用目录:`ANTIGRAVITY_GEMINI_DIR` 指向 `.gemini` 目录本身,CLI 自己的状态在 `~/.gemini/antigravity-cli` 里。

显示 Agent 名称时,查找 `builtinProviders.find((provider) => provider.id === id)?.identity?.displayName`。添加 provider 见 [Provider](/docs/concepts/providers)。
9 changes: 9 additions & 0 deletions apps/website/src/features/docs/agent-identity.ts
Original file line number Diff line number Diff line change
Expand Up @@ -99,5 +99,14 @@ export const AGENT_IDENTITY: readonly AgentIdentity[] = [
name: "ZCode",
aliases: [],
home: { en: "ZCODE_STORAGE_DIR, ~/.zcode", zh: "ZCODE_STORAGE_DIR,~/.zcode" }
},
{
id: "agy",
name: "Antigravity CLI",
aliases: [],
home: {
en: "ANTIGRAVITY_GEMINI_DIR (names the Gemini dir), ~/.gemini",
zh: "ANTIGRAVITY_GEMINI_DIR(指向 .gemini 目录本身),~/.gemini"
}
}
];
11 changes: 11 additions & 0 deletions infra/architecture/boundaries.ts
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,7 @@ const CURSOR = "@rivus/agent-kit-provider-cursor";
const PI = "@rivus/agent-kit-provider-pi";
const QODER = "@rivus/agent-kit-provider-qoder";
const KIMI = "@rivus/agent-kit-provider-kimi";
const AGY = "@rivus/agent-kit-provider-agy";
const DIM = "@rivus/agent-kit-provider-dim";
const DSH = "@rivus/agent-kit-provider-dsh";
const ZCODE = "@rivus/agent-kit-provider-zcode";
Expand Down Expand Up @@ -222,6 +223,15 @@ export const boundaries: BoundaryRules = {
testsOnly: [TESTING],
external: ["zod/mini"]
},
[AGY]: {
siblingEntries: [],
providerFacts: "packages/providers/agy/src/facts.ts",
providerServices: ["identity", "discovery", "acp"],
dependsOn: [],
spiImports: [CATALOG, DISCOVERY, ACP],
testsOnly: [TESTING],
external: []
},
[DSH]: {
siblingEntries: [],
providerFacts: "packages/providers/dsh/src/facts.ts",
Expand Down Expand Up @@ -298,6 +308,7 @@ export const boundaries: BoundaryRules = {
KIMI,
QODER,
DIM,
AGY,
ACP,
PLATFORM_NODE
],
Expand Down
22 changes: 11 additions & 11 deletions packages/agent-kit/.size-limit.ts
Original file line number Diff line number Diff line change
Expand Up @@ -14,26 +14,26 @@ const nodeOnly = {
// `pnpm size:update` sets every limit to the measured size plus headroom (scripts/lib/size-budgets.ts); do not edit them
// by hand.
export default [
{ name: "@rivus/agent-kit/providers", path: "dist/providers.js", import: "*", limit: "58657 B" },
{ name: "@rivus/agent-kit/providers", path: "dist/providers.js", import: "*", limit: "59404 B" },
// About 33 kB of it is the ACP SDK, a dependency the measurement includes. The entry and the SDK both parse with
// zod, which the measurement counts as well, so zod's own growth lands here.
{ name: "@rivus/agent-kit/acp", path: "dist/acp.js", import: "*", limit: "45515 B" },
{ name: "@rivus/agent-kit/catalog", path: "dist/catalog.js", import: "*", limit: "1055 B" },
{ name: "@rivus/agent-kit/acp", path: "dist/acp.js", import: "*", limit: "46094 B" },
{ name: "@rivus/agent-kit/catalog", path: "dist/catalog.js", import: "*", limit: "1090 B" },
// Pricing and summarization are pure; their entry imports nothing.
{ name: "@rivus/agent-kit/cost", path: "dist/cost.js", import: "*", limit: "1580 B" },
// Nearly all of it is the LiteLLM snapshot, about 10 B a model plus each model's long-context tier. The budget
// still fails when the filter admits another provider's routes or the entry starts bundling zod/mini.
{ name: "@rivus/agent-kit/cost/prices", path: "dist/cost/prices.js", import: "*", limit: "3651 B" },
{ name: "@rivus/agent-kit/discovery", path: "dist/discovery.js", import: "*", limit: "13050 B" },
{ name: "@rivus/agent-kit/cost/prices", path: "dist/cost/prices.js", import: "*", limit: "3655 B" },
{ name: "@rivus/agent-kit/discovery", path: "dist/discovery.js", import: "*", limit: "13208 B" },
// About 25 kB of the kit's own code; the rest is its editors, @decimalturn/toml-patch (about 40 kB) and zod/mini
// (about 5 kB) above all. The bridges carry the per-event finish selectors and their payload check, and the
// read-only legacy listing adds the shared legacyTreatment rule and its use case. shell-quote, which reads a hook
// command's first word for doctor, is counted with the entry. Configuration cleanup also carries the ledger
// creation proof and its invalidation when the original entries disappear. Install-plan and bundle values own
// validation and copy their inputs before freezing; legacy command content is parsed at the application boundary.
{ name: "@rivus/agent-kit/harness", path: "dist/harness.js", import: "*", limit: "89361 B" },
{ name: "@rivus/agent-kit/harness", path: "dist/harness.js", import: "*", limit: "89605 B" },
// The entry keeps parsing to zod schemas, so it now carries zod/mini, bundled in by `vp pack`.
{ name: "@rivus/agent-kit/harness/events", path: "dist/harness/events.js", import: "*", limit: "8611 B" },
{ name: "@rivus/agent-kit/harness/events", path: "dist/harness/events.js", import: "*", limit: "8761 B" },
// The Node platform parses system-error codes with zod/mini, which size-limit counts into the entry.
{ name: "@rivus/agent-kit/node", path: "dist/node.js", import: "*", limit: "6486 B", ...nodeOnly },
{ name: "@rivus/agent-kit/node/effect", path: "dist/node/effect.js", import: "*", limit: "6561 B", ...nodeOnly },
Expand All @@ -49,9 +49,9 @@ export default [
// The claude-code summarize pass, the streaming time merge and the prompts rule grow /sessions and /transcript,
// and the prompts conformance check grows /testing; the Codex and Grok passes and their shared record dispatches
// grow all three.
{ name: "@rivus/agent-kit/sessions", path: "dist/sessions.js", import: "*", limit: "40023 B" },
{ name: "@rivus/agent-kit/testing", path: "dist/testing.js", import: "*", limit: "24654 B", ...nodeOnly },
{ name: "@rivus/agent-kit/sessions", path: "dist/sessions.js", import: "*", limit: "40115 B" },
{ name: "@rivus/agent-kit/testing", path: "dist/testing.js", import: "*", limit: "24812 B", ...nodeOnly },
{ name: "@rivus/agent-kit/testing/effect", path: "dist/testing/effect.js", import: "*", limit: "2425 B" },
{ name: "@rivus/agent-kit/transcript", path: "dist/transcript.js", import: "*", limit: "39552 B" },
{ name: "@rivus/agent-kit/transcript/usage", path: "dist/transcript/usage.js", import: "*", limit: "23408 B" }
{ name: "@rivus/agent-kit/transcript", path: "dist/transcript.js", import: "*", limit: "40008 B" },
{ name: "@rivus/agent-kit/transcript/usage", path: "dist/transcript/usage.js", import: "*", limit: "23447 B" }
] satisfies SizeLimitConfig;
Loading
Loading