What an integration does
Gallager hooks into each agent's lifecycle so every session in the sidebar shows a live status — working, needs permission, waiting for an answer, idle, done. When an agent asks something, the actual permission prompt or question form surfaces in Gallager, on your Mac and on your phone, and your answer is delivered back into the agent's terminal. Integrations can also feed the per-session token/cost/latency meter via OpenTelemetry.
The Claude Code and Codex CLI integrations ship inside the app and are set up from Settings → Agents.
Installing a sidecar plugin
Other agents are supported through sidecar plugins: standalone executables that Gallager spawns and talks to over JSON-RPC. Three are published today, foropencode, pi and omp(oh-my-pi). Install fromSettings → Agents → Add Plugin from URL… by pasting the manifest URL, or from the command line:
gallager plugin install https://updates.gallager.app/plugins/opencode/plugin.json gallager plugin install https://updates.gallager.app/plugins/pi/plugin.json gallager plugin install https://updates.gallager.app/plugins/omp/plugin.json
Installs are deliberately paranoid: HTTPS-only manifests, a trust dialog showing publisher, version and bundle URL before anything is downloaded, SHA-256 verification of the bundle, and hardened unpacking. Local .zip installs (Settings → Agents → Install from Zip…) follow the same flow. Update later withgallager plugin update <id>, remove withgallager plugin uninstall <id>.
What a plugin can do
- Report session state per pane — working, done, needs attention, ended
- Open real permission and question forms, answered from Mac or iPhone
- Fire desktop and push notifications when the agent needs you
- Send text and keystrokes into the agent's terminal
- Surface the agent's projects in the "new session" menu
- Report token, cost and latency telemetry into the session meter
Writing your own
A plugin is a directory with a plugin.json manifest and an executable — any language works (the published ones are Python). The full authoring contract lives in the repo at docs/plugins/sidecar-authoring.md, alongside three complete, working examples under plugins/opencode/, plugins/pi/ andplugins/omp/. A packaging script builds and checksums the distributable bundle for you.