opencode-rust-coder

opencode-rust-coder

Türkçe | English

An OpenCode V2 plugin that helps coding agents produce correct, idiomatic Rust. It structures Cargo diagnostics, adds rust-analyzer navigation, produces write-free rename/refactor plans, verifies crates, and reads version-pinned Rust API documentation.

Current Release

The latest stable release is 0.2.5.

Surface	Verified release
npm	opencode-rust-coder@0.2.5
GitHub	v0.2.5

Release 0.2.5 adds the bounded two-clock validation gate, streamed and cancel-safe Cargo execution, stale-result rejection, worktree scheduling, and deterministic validation benchmarks.

Highlights

• Structured cargo check, test, Clippy, and format feedback.
• A two-clock validation gate: bounded FAST_PASS feedback and authoritative FULL_PASS only after format, Clippy, all targets, and applicable doctests.
• Crates.io verification and common Rust mistake detection.
• Rust Analyzer hover, symbols, references, definitions, implementations, and call hierarchy.
• Rename and refactor suggestions that never write to the workspace.
• Exact Cargo.lock version resolution with local rustdoc/docs.rs fallback.
• Bounded, advisory automation that remains inactive in non-Rust projects.

Requirements

• OpenCode V2 with a plugin API compatible with the pinned @opencode-ai/plugin@0.0.0-beta-18050 target.
• A Rust toolchain with Cargo for compiler-backed tools.
• rust-analyzer for semantic rust.* tools. Resolution order is the explicit rustAnalyzerPath, PATH, then ~/.cargo/bin/rust-analyzer.
• Bun 1.3.14 for repository development and release checks.

Install

Install the exact current release globally:

opencode2 plugin add opencode-rust-coder@0.2.5
opencode2 plugin list

plugin add updates the global OpenCode V2 configuration. Exact versions stay pinned. Configuration-directory changes reload automatically; if an existing server does not reflect the changed package, use opencode2 service restart as a troubleshooting step.

Configure

To pass options, replace the string entry in ~/.config/opencode/opencode.jsonc with the object form:

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": [
    {
      "package": "opencode-rust-coder@0.2.5",
      "options": {
        "autoGate": true,
        "autoCrateCheck": true,
        "autoAudit": true,
        "autoLsp": false,
        "toolInvites": true,
        "maxTokens": 900,
        "gateResponseMs": 30000,
        "gateHostConcurrency": 1,
        "gateCacheMode": "auto",
        "gateScopeMode": "shadow",
        "tools": {
          "check": true,
          "audit": true,
          "crate": true,
          "hints": true,
          "lsp": true,
          "rename": true,
          "refactor": true,
          "docs": true
        }
      }
    }
  ]
}

The shown values are the defaults. autoLsp is intentionally opt-in. Use toolchainPath or rustAnalyzerPath only when normal executable discovery is not sufficient.

Use

The plugin registers the auto-invoked opencode-rust-coder runtime skill. It does not create or replace an agent. In a Rust workspace, ask the active agent to implement or debug normally; the skill directs it to the appropriate rust.* tools.

Useful explicit requests include:

Run rust.check with target "all" before finishing.
Use rust.crate_lookup before adding the dependency.
Trace callers with rust.hierarchy before changing this function.
Prepare a write-free rust.rename plan for this symbol.

Tools

Tool	Purpose
rust.check	Run Cargo check, test, doctest, Clippy, format, or the full gate
rust.audit	Find common agent-generated Rust pitfalls
rust.crate_lookup	Verify crate names and published versions
rust.symbol	Show hover type and documentation
rust.symbols	List document symbols
rust.references	Find semantic references
rust.definition	Open the semantic definition
rust.implementations	Find trait/type implementations
rust.hierarchy	Inspect incoming/outgoing calls
rust.rename	Produce a verified, write-free rename package
rust.refactor	List code actions without executing commands or edits
rust.docs	Read version-pinned rustdoc or docs.rs content

Defaults And Safety

• autoGate, autoCrateCheck, and autoAudit are enabled only in detected Rust workspaces and are session-limited.
• Validation returns FAST_PASS, FULL_PASS, FAIL, or a non-authoritative state such as PENDING, STALE, or RESOURCE_BLOCKED. A 30-second response budget never turns unfinished work into a pass.
• Cargo work is streamed asynchronously, coalesced and serialized per worktree, limited by host leases, and rejected when its content identity becomes stale.
• FULL_PASS always uses the complete workspace scope and a separate applicable doctest command. Affected-package scope remains in shadow mode by default.
• autoLsp is disabled by default and has a deadline and per-session quota when enabled.
• Rename/refactor tools never modify files or run server-returned commands.
• Workspace and symlink escapes are rejected. Rustdoc cache lives outside the workspace.
• Cargo selection isolates linked worktrees, resolves a sole bounded nested workspace, rejects ambiguous roots, and reports the selected manifest.
• Tool activity records only timing, size, status, and outcome metadata. It does not record tool input, output, source, errors, or message content.
• All injected guidance is advisory. Compiler and test output remain the source of truth, and plugin failures remain fail-open.

Documentation And Support

• Architecture
• Benchmark Design
• Validation Implementation Plan
• Rust Guidance Research
• Latest GitHub Release
• Bug reports and feature requests
• Security policy
• Contributing guide
• Code of conduct

Development

bun install --frozen-lockfile
bun scripts/check-release-docs.ts
bun run typecheck
bun test
bun run build
bun run benchmark:validation:smoke

The release gate is bun run typecheck && bun test && bun run build. dist/ is generated and must not be edited manually. The previous full benchmark is invalid because of a scorer/workspace failure and is not release evidence; a paid rerun requires a repaired harness and explicit approval.

Maintainers should follow the version and tag consistency checklist in the release process.

License

MIT © 2026 Uğur Murat Altıntaş