vakandi/opencode-rust

选用指南

AI 根据 README 整理 · 2026/10/21 08:36:08

使用方式

通过 CLI、TUI 或 HTTP 服务器使用，支持交互式 TUI、单次运行和 HTTP 服务模式。

查看 README 依据

code is unchanged skips the rebuild entirely; `--force` rebuilds regardless. ```bash opr # interactive TUI opr run "check this repo for risks" # one prompt, runs to completion opr serve --port 3000 # HTTP server ``` > **`opr` behaves slightly differently per install.** Through npm it is a dispatching script, so > `opr --some-flag` becomes `opencode tui --some-flag`. Through Homebrew and `install.sh` it is the > engine binary itself (Homebrew installs it under the name `opr`), so the same command becomes

部署要求

需要 Node 18+，因为引擎会为插件桥接和 MCP 服务器启动 Node 子进程；首次运行前需要设置提供商 API 密钥。

查看 README 依据

> `--some-flag` and is rejected — name the subcommand instead (`opr tui --some-flag`). ### Named-agent shortcuts `install.sh` also installs one shortcut per agent, each running a single prompt as that agent: ```bash gilfoyle "fix this failing test" # --agent gilfoyle setbon "write 5 ad hooks" # --agent setbon googlebot "audit my meta tags" # --agent googlebot ``` No prompt given → usage on stderr and exit 2. ### Requirements Node 18+. The engine spawns Node subprocesses for its plugin bridge and launches MCP servers

through `npx`, so Node is required regardless of how it was installed. A provider key is needed before the first run: ```bash export ANTHROPIC_API_KEY=sk-ant-... ``` --- ## Why Rust OpenCode's engine was TypeScript. It held conversation history in RAM, re-derived the full tool schema set on every LLM step, and kept per-directory instance state (MCP servers, LSP servers, plugins) unbounded and never evicted. A Docker runtime existed to *contain* that. It wasn't enough. Five teams of five agents pinned the CPU at 99% on a MacBook Pro M5 and the

已知限制

run 命令尚未针对付费提供商进行端到端验证，免费 OpenRouter 模型拒绝工具模式，付费模型在无信用时返回 402。

查看 README 依据

cd npm && npm publish --access public ``` Order matters: the binary package must be on the registry before the launcher, because the launcher declares it as an optional dependency. --- ## Development ```bash cargo test --workspace # 571 tests cargo build --release --bin opencode cargo clippy --workspace --all-targets ``` --- ## Known limitation `run` is verified against a real `bash` tool through the real session engine. It has **not** been exercised end-to-end against a funded provider: free OpenRouter models reject the tool schema and

paid ones return 402 without credits. The loop is provider-agnostic, but we publish what we measured rather than a result we did not get. --- ## License MIT — see [LICENSE](./LICENSE). A Rust implementation of [OpenCode](https://github.com/anomalyco/opencode). Not affiliated with the OpenCode team.