Files
orca/docs/reference/codebuddy-harness.md
T
Neil ccdb324b63 Add CodeBuddy as a built-in coding agent (#23740)
* feat(agents): integrate CodeBuddy launch, status and session history

* docs: record CodeBuddy lifecycle verification

* fix(codebuddy): backfill scoped history and negotiate remote resume

* test(cli): include CodeBuddy in known search agents
2026-09-28 18:11:25 -07:00

2.3 KiB

CodeBuddy terminal harness

CodeBuddy uses its own identity in the desktop and mobile agent catalogs, process detection, telemetry, hooks, resume records and AI Vault. codebuddy and cbc identify the interactive CLI; print, server, ACP and detached background modes do not identify an interactive pane. Model and effort selections use --model and --effort; the CLI resolves its stable model aliases for the current account.

Managed hooks use the existing Claude-compatible installer and transport, with CodeBuddy's own .codebuddy/settings.json and hook source. Installation preserves user hooks and statusline configuration. Local and SSH installers share the same plan; Windows explicitly selects CodeBuddy's supported PowerShell hook shell. Status flows through the execution host's canonical hook store.

Observed lifecycle

Verified with the authenticated CodeBuddy 2.159.0 CLI on macOS:

  • UserPromptSubmit starts work. SessionStart can arrive afterward and must not settle that work.
  • An unanswered AskUserQuestion emits a Notification with notification_type: permission_prompt and the message needs your permission to use AskUserQuestion.
  • In this version, PreToolUse(AskUserQuestion) arrives after the user answers; it resumes working, followed by PostToolUse and Stop.
  • Stop supplies the final assistant message and the provider session identity supplies the resume command.

The sanitized real event sequence is src/shared/__fixtures__/codebuddy-question-hooks.jsonl. The regression test replays it through the shared hook listener. Qoder keeps its existing lifecycle semantics while sharing the common event projection.

AI Vault reads CodeBuddy's type: message JSONL records with top-level roles and input_text / output_text content blocks. Local, WSL and SSH discovery use the provider's .codebuddy/projects tree and the same incremental parser.

Validation scope

Live macOS checks exercised launch through Orca's agent menu, model switching, question waiting, answer submission, working and completion indicators, history discovery and a resumed session recalling its earlier answer. Hidden-renderer CDP screenshots record the working, question and completed states. Windows, Linux, WSL and SSH runtime execution have not been exercised live on this machine.