optionOS optionOS

Set up Cockpit in VS Code

How do I use it?
Tags
  • FEATUREVisible app capability.
  • SETUPSetup or connection action.

optionOS — Cockpit has two surfaces: the Mac app opens on its own; live agent sessions require the VS Code extension over a local bridge.

Once running, every agent session shows up in one live panel — working, waiting, awaiting your answer, all together.

Cockpit live agent session panel
Cockpit live agent session panel

Every session is a card: its name, state, model, how many sub-agents it ran, tokens spent, files edited, age, and which branch it forked onto — all on one card.

Cockpit agent session card
Cockpit agent session card

Setup is four steps:

1 — Install the extension. For live agent sessions, install the optionOS - Cockpit extension in VS Code. The Mac app is installed separately and can run from the location chosen by the user.

optionOS Cockpit VS Code extension
optionOS Cockpit VS Code extension

2 — Open a workspace. Cockpit setup is per-workspace; open your project as a VS Code workspace first.

3 — Run setup. Open the Command Palette (⌘⇧P) and run optionOS - Cockpit: Install. This wires your Claude Code and Codex hooks, VS Code workspace settings, and the Mac↔VS Code bridge automatically.

4 — Verify. The optionOS - Cockpit: Doctor command lists every piece as GREEN/RED. When all are GREEN, your sessions start showing live in both the VS Code sidebar and the Mac panel.

If something breaks, run optionOS - Cockpit: Repair; to undo everything, optionOS - Cockpit: Uninstall.