Back to Directory Sidekick - OpenCode icon

Sidekick - OpenCode

Launches OpenCode as a live call companion when Tuple Capture starts. Opens a terminal running `tuple connect --harness opencode`, which gives OpenCode the call context and points it at the live Capture.


Launches OpenCode as a live companion on your Tuple call when Capture starts.

When call-capture-started fires, this trigger opens your preferred terminal and runs tuple connect --harness opencode. Connect resolves the call state, gives OpenCode a context prompt, and points it at the live transcript — so OpenCode catches up on everything said so far, then watches the call as it happens and acts as a sharp third pair.

What it does

tuple connect brings OpenCode into the call and tells it how to follow the version-matched Capture stream. Guided by connect's prompt, OpenCode:

  • Logs the call live — a one-line · play-by-play on each batch of new transcript, so you can follow along at a glance.
  • Chimes in when it matters — a real interjection for a bug it can see, an ambiguous decision or action item, a correction, or a direct question.
  • Answers when addressed — say "OpenCode, ..." (or type into the terminal) and it responds, then keeps listening.
  • Summarizes — a checkpoint when recording stops, and a final summary (decisions, action items, open threads) when the call ends.

Because the trigger just hands off to tuple connect, there's nothing call-format-specific in it: how OpenCode reads the call lives in connect's prompt, in the CLI. Nothing is hard-coded about the model either — OpenCode uses whatever you have configured.

Choosing your terminal

By default the trigger opens your system's default handler for .command files. To force a specific terminal, set PREFERRED_TERM at the top of call-capture-started (or in the environment):

PREFERRED_TERM="iterm"   # ghostty | iterm | alacritty | terminal

The terminal runs launch-sidekick-opencode.command, whose #!/bin/zsh -li shebang sources your shell profile, so tuple and opencode resolve from the same PATH you get in a normal terminal.

Prerequisites

  • macOS
  • OpenCode installed so opencode works in a new terminal
  • The tuple CLI on your interactive shell PATH (with connect and capture support)
    • Install it from the Tuple app: its Capture settings have an Install button that links tuple onto your PATH.
  • Tuple Capture enabled for the call

Installation

Drop this directory into your Tuple triggers folder:

~/.tuple/triggers/sidekick-opencode/

The trigger fires the next time call Capture starts.

How it works

call-capture-started supplies the call and recording IDs through environment variables, not positional arguments. This trigger:

  1. Creates a working directory per start, ${TMPDIR:-/tmp}/tuple-sidekick-opencode/<timestamp>-<pid>.
  2. Shell-quotes both IDs into trigger-context.sh and writes an executable launch-sidekick-opencode.command wrapper.
  3. Opens it in your preferred terminal via open (LaunchServices). No AppleScript and no direct binary launch, so it triggers no macOS accessibility prompt and no stray windows.
  4. The wrapper starts a login-interactive zsh, sources the trigger context, and runs tuple connect --harness opencode. Connect selects the live current session; the exact trigger IDs remain available to the launched agent and its Tuple commands.

There is no dedup: each Capture start gets its own directory, so stopping and restarting Capture spawns a fresh companion while older ones keep running.

For local testing without opening a terminal, set SIDEKICK_OPENCODE_DRY_RUN=1; it writes the launcher and exits.