π« Toolkit to help you get started with SDD or any other process!
"""opencode integration."""
from collections.abc import Mapping, Sequence
from pathlib import Path
from typing import Any
from ..base import MarkdownIntegration
class OpencodeIntegration(MarkdownIntegration):
key = "opencode"
multi_install_safe = True
config = {
"name": "opencode",
"folder": ".opencode/",
"commands_subdir": "commands",
"install_url": "https://opencode.ai",
"requires_cli": True,
}
registrar_config = {
"dir": ".opencode/commands",
"legacy_dir": ".opencode/command",
"format": "markdown",
"args": "$ARGUMENTS",
"extension": ".md",
}
CANONICAL_TO_NATIVE = {
"pre_tool_use": "tool.execute.before",
"post_tool_use": "tool.execute.after",
# session_start maps to the system-prompt transform hook (not the
# session.created event) so the handler's stdout is injected into the
# system prompt β session.created has no output channel. The hook
# fires per LLM request, which keeps the context present across
# compaction at the cost of running the handler per turn.
"session_start": "experimental.chat.system.transform",
# user_prompt_submit maps to chat.message so handler stdout is
# injected as a synthetic text part on the user's message.
"user_prompt_submit": "chat.message",
"session_end": "session.deleted",
}
events_config_file = "opencode.json"
events_format = "ts-plugin"
def build_exec_args(
self,
prompt: str,
*,
model: str | None = None,
output_json: bool = True,
integration_args: Sequence[str] | None = None,
integration_options: Mapping[str, Any] | None = None,
project_root: Path | None = None,
) -> list[str] | None:
self.validate_runtime_config(integration_args, integration_options)
args = [self._resolve_executable(), "run"]
# Apply operator-injected extra args before the prompt-derived
# --command and the canonical --format/-m flags so Spec Kit's
# later appends remain authoritative under repeated-flag CLI
# semantics.
self._apply_extra_args_env_var(args)
message = prompt
if prompt.startswith("/"):
command, _, remainder = prompt[1:].partition(" ")
if command:
args.extend(["--command", command])
message = remainder
if model:
args.extend(["-m", model])
if output_json:
args.extend(["--format", "json"])
if message:
args.append(message)
return args