Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

docs: cover TraeCode CLI 2.0 in the TRAE onboarding cards (#5259)

t0sakibdff7dbaac8b
diff --git a/docs/en/agent-integrations/13-trae.md b/docs/en/agent-integrations/13-trae.md
index cf12dbb3b..f902194c8 100644
--- a/docs/en/agent-integrations/13-trae.md
+++ b/docs/en/agent-integrations/13-trae.md
@@ -41,7 +41,7 @@ Quit and restart the corresponding client after installation.
### TraeCode CLI 2.0: trust the hooks on first launch
-TraeCode CLI 2.0 uses the Codex plugin format, where hooks only run once you trust them. Starting `trae-cli` stops on this prompt — pick **Trust all and continue**, or Review hooks first if you want to read the commands:
+TraeCode CLI 2.0 hooks only run once you trust them. Starting `trae-cli` stops on this prompt — pick **Trust all and continue**, or Review hooks first if you want to read the commands:
```text
Hooks need review
diff --git a/docs/images/agents/en/trae.md b/docs/images/agents/en/trae.md
index f3750a59b..87a55a008 100644
--- a/docs/images/agents/en/trae.md
+++ b/docs/images/agents/en/trae.md
@@ -1,6 +1,6 @@
## Step 1: Install
-1. Run the command that matches your TRAE version:
+1. Run the command that matches your client:
**Trae International**
@@ -14,6 +14,12 @@
bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) --harness trae-cn --dist tos
```
+ **TraeCode CLI 2.0**
+
+ ```bash
+ bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) --harness trae-cli --dist tos
+ ```
+
2. The installer will ask for language (English / Chinese) and OpenViking credentials. In the OpenViking credential step, choose **VolcEngine OpenViking Cloud Service [api.vikingdb.cn-beijing.volces.com]** and enter the API KEY:
```text
@@ -22,17 +28,32 @@
## Step 2: Verify
-Open **Settings → MCP → Configured MCP Servers** and confirm that the `openviking` entry is visible.
+**TRAE / TRAE CN**: open **Settings → MCP → Configured MCP Servers** and confirm that the `openviking` entry is visible.
+
+**TraeCode CLI 2.0**: hooks only run once you trust them. Start `trae-cli` and pick **Trust all and continue** at the prompt:
+
+```text
+Hooks need review
+6 hooks are new or changed.
+Hooks can run outside the sandbox after you trust them.
+
+ 1. Review hooks
+> 2. Trust all and continue
+ 3. Continue without trusting (hooks won't run)
+```
+
+Then run `trae-cli plugin list` and confirm that `openviking-memory` is enabled. If you miss the prompt or pick the third option, the hooks never run: enter `/hooks` to trust and enable the entries, and check `/plugins` shows the plugin as enabled — two independent switches, both have to be on. A plugin update that touches a hook asks for trust again.
## Troubleshoot
| Problem | Fix |
|---|---|
| No auto recall | Quit TRAE completely, restart, new Agent session |
-| Connection / auth fails | Check `~/.openviking/ovcli.conf` and restart TRAE |
-| Need logs | `~/.openviking/logs/trae-hooks.log` or `trae-cn-hooks.log` |
+| TraeCode CLI 2.0 has the plugin but recalls nothing | The startup hook trust was skipped: trust and enable in `/hooks`, confirm the plugin is enabled in `/plugins` |
+| Connection / auth fails | Check `~/.openviking/ovcli.conf` and restart the client |
+| Need logs | `~/.openviking/logs/trae-hooks.log`, `trae-cn-hooks.log`, or `codex-hooks.log` (TraeCode CLI 2.0) |
## Reference
- Docs on Manual Settings: [TRAE](https://docs.openviking.net/en/agent-integrations/13-trae)
-- Code: [examples/agent-hook-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/agent-hook-plugin)
+- Code: [examples/agent-hook-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/agent-hook-plugin) (TRAE / TRAE CN), [examples/codex-memory-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/codex-memory-plugin) (TraeCode CLI 2.0)
diff --git a/docs/images/agents/zh/trae.md b/docs/images/agents/zh/trae.md
index 08081d5e5..6b08d9e55 100644
--- a/docs/images/agents/zh/trae.md
+++ b/docs/images/agents/zh/trae.md
@@ -1,6 +1,6 @@
## 步骤1:安装
-1. 根据所使用的版本,在终端执行对应的安装命令:
+1. 根据所使用的客户端,在终端执行对应的安装命令:
**Trae 国际版**
@@ -14,6 +14,12 @@
bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) --harness trae-cn --dist tos
```
+ **TraeCode CLI 2.0**
+
+ ```bash
+ bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shared/install.sh) --harness trae-cli --dist tos
+ ```
+
2. 安装器会依次询问以下信息:语言(English / 中文)、OpenViking 凭据。在 OpenViking 凭据配置中,选择连接至「火山引擎 OpenViking 云服务 [api.vikingdb.cn-beijing.volces.com]」,并填入 API KEY:
```text
@@ -22,17 +28,32 @@
## 步骤2:验证
-在「设置 → MCP → 已配置的 MCP Servers」中确认能够看到 `openviking` 条目即表示接入成功。
+**TRAE / TRAE CN**:在「设置 → MCP → 已配置的 MCP Servers」中确认能够看到 `openviking` 条目即表示接入成功。
+
+**TraeCode CLI 2.0**:Hook 要先信任才会运行。启动 `trae-cli`,在信任确认上选 **Trust all and continue**:
+
+```text
+Hooks need review
+6 hooks are new or changed.
+Hooks can run outside the sandbox after you trust them.
+
+ 1. Review hooks
+> 2. Trust all and continue
+ 3. Continue without trusting (hooks won't run)
+```
+
+再执行 `trae-cli plugin list`,确认 `openviking-memory` 已启用。错过这个提示,或当时选了第 3 项,Hook 就不会运行:输入 `/hooks` 补上信任并开启条目,`/plugins` 里确认插件已启用——两个开关相互独立,都要是开着的。插件更新动了 Hook 时会再要求信任一次。
## 故障排查
| 问题 | 处理 |
|---|---|
| 没有自动召回 | 完全退出 TRAE,重启,再建会话 |
-| 连接 / 鉴权失败 | 检查 `~/.openviking/ovcli.conf`,重启 TRAE |
-| 需要日志 | `~/.openviking/logs/trae-hooks.log` 或 `trae-cn-hooks.log` |
+| TraeCode CLI 2.0 装了插件但不召回 | 启动时的 Hook 信任被跳过:`/hooks` 里信任并开启,`/plugins` 里确认插件已启用 |
+| 连接 / 鉴权失败 | 检查 `~/.openviking/ovcli.conf`,重启客户端 |
+| 需要日志 | `~/.openviking/logs/trae-hooks.log`、`trae-cn-hooks.log` 或 `codex-hooks.log`(TraeCode CLI 2.0) |
## 参考
- 手动配置文档:[TRAE](https://docs.openviking.net/zh/agent-integrations/13-trae)
-- 源码:[examples/agent-hook-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/agent-hook-plugin)
+- 源码:[examples/agent-hook-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/agent-hook-plugin)(TRAE / TRAE CN)、[examples/codex-memory-plugin](https://github.com/volcengine/OpenViking/tree/main/examples/codex-memory-plugin)(TraeCode CLI 2.0)
diff --git a/docs/zh/agent-integrations/13-trae.md b/docs/zh/agent-integrations/13-trae.md
index 60562c41c..f8cab7b03 100644
--- a/docs/zh/agent-integrations/13-trae.md
+++ b/docs/zh/agent-integrations/13-trae.md
@@ -41,7 +41,7 @@ bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shar
### TraeCode CLI 2.0:首次启动信任 hooks
-TraeCode CLI 2.0 用的是 Codex 插件格式,hooks 要先信任才会运行。启动 `trae-cli` 时会停在这个确认上,选 **Trust all and continue**;想先看一眼 hook 命令就选 Review hooks:
+TraeCode CLI 2.0 的 hooks 要先信任才会运行。启动 `trae-cli` 时会停在这个确认上,选 **Trust all and continue**;想先看一眼 hook 命令就选 Review hooks:
```text
Hooks need review