agent-harness-adapter-core 0.2.2

One agent setup, every coding agent: install instructions, skills and hooks, declared once or read from AGENTS.md and .agents/, into Claude Code, Codex, Gemini CLI, Copilot, Cursor, OpenCode and more; hooks speak Claude Code's protocol everywhere.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

//! OpenCode (`opencode-ai`).
//!
//! Follows `packages/web/src/content/docs/` of
//! <https://github.com/sst/opencode> (`rules.mdx`, `config.mdx`,
//! `skills.mdx`, `agents.mdx`, `commands.mdx`, `mcp-servers.mdx`,
//! `permissions.mdx`, `plugins.mdx`) and its source (`session/instruction.ts`,
//! `config/plugin.ts`, `session/prompt.ts`, `session/tools.ts`,
//! `cli/cmd/run.ts`), version 1.18.35 (checked 2026-10-07).
// @zen-component: HAR-OpenCode

use crate::{
    Result,
    common::{extension, plugin},
    harness::{Context, Harness, Part, PartResult, Reads, Scope},
    hook::{Answer, Event, HookInput, Output, ToolCall, claude_names},
    integration::{Integration, Item},
};

/// OpenCode (`opencode`).
#[derive(Debug, Clone, Copy, Default)]
pub struct OpenCode;

const ID: &str = "opencode";

/// OpenCode's paths: the project's `.opencode` and `opencode.json`, or
/// `~/.config/opencode` and its `opencode.json`. The instructions file is
/// the first of `AGENTS.md`, `CLAUDE.md` that exists
/// (`.config/opencode/AGENTS.md`, `.claude/CLAUDE.md` at user scope), else
/// the first; OpenCode loads only that one.
// @zen-impl: HAR-10_AC-2
const LAYOUT: plugin::Layout = plugin::Layout {
    harness: ID,
    agent: "OpenCode",
    types: "@opencode-ai/plugin",
    project_dir: ".opencode",
    user_dir: ".config/opencode",
    config: "opencode.json",
    also_config: &[],
};

impl Harness for OpenCode {
    fn id(&self) -> &str {
        ID
    }

    /// Every event but one: no session end.
    // @zen-impl: HAR-10_AC-3
    fn hook_events(&self) -> &[Event] {
        &[
            Event::SessionStart,
            Event::PromptSubmit,
            Event::PreTool,
            Event::PostTool,
            Event::Stop,
            Event::PreCompact,
        ]
    }

    // @zen-impl: HAR-15_AC-1
    fn program(&self) -> Option<&str> {
        Some("opencode")
    }

    fn claude_tool(&self, call: &ToolCall) -> ToolCall {
        claude_names::named(call, plugin::claude_name(&call.name))
    }

    // @zen-impl: HAR-10_AC-1
    fn scopes(&self) -> &[Scope] {
        &[Scope::Project, Scope::User]
    }

    // @zen-impl: HAR-10_AC-3
    // @zen-impl: HAR-10_AC-5
    // @zen-impl: HAR-10_AC-6
    // @zen-impl: HAR-10_AC-7
    fn render(&self, integration: &Integration, cx: &Context) -> Result<Vec<Part>> {
        LAYOUT.render(integration, cx)
    }

    fn reads(&self, item: Item, cx: &Context) -> Result<Reads> {
        Ok(LAYOUT.reads(item, cx))
    }

    // @zen-impl: HAR-10_AC-4
    fn parse_hook(&self, event: Event, text: &str) -> serde_json::Result<HookInput> {
        extension::parse(ID, event, text, plugin::tool_kind)
    }

    // @zen-impl: HAR-10_AC-4
    // @zen-impl: AHA-2_AC-3
    fn answer(&self, event: Event, answer: &Answer) -> Result<Output> {
        extension::answer(ID, event, answer)
    }

    // @zen-impl: HAR-10_AC-8
    fn notes(&self, _cx: &Context, parts: &[PartResult]) -> Vec<String> {
        if parts.iter().any(PartResult::changed) {
            vec!["restart OpenCode to load the changes".into()]
        } else {
            Vec::new()
        }
    }
}

#[cfg(test)]
#[path = "tests.rs"]
mod tests;