Guides
Chrome Extension
Open and focus PRs in Chrome from fleet — without spawning a new tab every time.
The p key opens the current session's PR in Chrome and reuses an existing tab if one is already open. If Chrome isn't running or the extension isn't installed, it falls back to open <url>.
Architecture
fleet TUI ──[unix socket]──▶ fleet chrome-host ──[stdio native messaging]──▶ Chrome service worker- Unix socket:
~/.config/fleet/chrome.sock(mode0600, created by the native host) - Native messaging host: the
fleet chrome-hostsubcommand (auto-detected when Chrome passes achrome-extension://...arg) - NMH manifest: auto-installed to
~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.brizzai.fleet.tabcontrol.jsonon TUI startup - Extension ID:
haphpcoecelhofejcklinnlbfijgdnih(stable viakeyinmanifest.json)
Install the extension
The extension lives in the fleet repo. Until it's on the Chrome Web Store:
- Open
chrome://extensions - Toggle Developer mode (top right)
- Click Load unpacked
- Pick
chrome-extension/from your fleet checkout
The NMH manifest is installed automatically the next time you launch fleet.
Commands the extension supports
| Command | What it does |
|---|---|
open_or_focus | Open a URL, or focus its tab if already open |
close_tab | Close a tab by URL |
create_tab_group | Group tabs by name |
ping | Health check |
Reconnect behavior
The service worker reconnects to the native host on disconnect (2s delay). If you restart fleet, the extension picks it back up automatically.
Falling back
If anything in the chain is missing, p falls back to:
open <pr-url>…which still works — you just get a fresh tab every time.