topencode

Manage multiple opencode projects and sessions as mouse-driven tabs inside a single, attachable tmux session. Built for remote/ssh workflows: run it on the box, topencode from anywhere, and every live opencode session is a clickable tab.

• opencode is great locally but awkward on remote hosts. topencode wraps it in one dedicated tmux session you can attach to over ssh.
• Multiple sessions/projects become tabs (tmux windows). Click a tab in the status bar to switch.
• A Home dashboard (window 0) is a two-column, fully mouse-driven browser of every project and session — scroll with the wheel, click to open.
• Each session tab is split 65% opencode / 35% clean zsh, so you always have a shell for git/build/logs next to the AI.

 topencode                         click ▸ browse/open   wheel ▸ scroll   q ▸ quit
PROJECTS                      SESSIONS — fancy-tmux
 fancy-tmux  (1/3)          │ ＋ New session
 k2          (0/12)         │ ● TUI+tmux design      now
 WorkSpace   (2/5)          │ ○ refactor cli          3h
                            │ ○ fix bug #42           2d

Each session tab:

┌ opencode <dir> -s <id>  (65%) ─────┬ clean zsh (35%) ─┐
│                                    │                  │
└────────────────────────────────────┴──────────────────┘

Requires: tmux 3.0+, zsh, opencode, Bun 1.3+.

bun install
bun run install:local     # builds a single binary -> ~/.local/bin/topencode

Make sure ~/.local/bin is on your PATH.

topencode                 # attach (create the tmux session if needed)
topencode attach          # same as above
topencode list            # list all sessions grouped by project (plain stdout)
topencode open <id>       # open/select a tab for a session id
topencode new [dir]       # start a new opencode session tab (default: cwd)
topencode close <tab|id>  # close a tab (does NOT delete the opencode session)
topencode kill            # kill the whole topencode tmux session

• Attach from outside tmux → tmux attach.
• Attach from inside another tmux → switch-client (no nested tmux trap).
• Clicking a session in the dashboard: if it's already live, jumps to its tab; if dormant, opens a new tab and launches opencode.

• The opencode pane enables its own mouse tracking (SGR), so the wheel scrolls opencode's view natively — no tmux copy-mode friction.
• The dashboard parses SGR mouse itself; each column scrolls independently with the wheel.
• The zsh pane uses tmux mouse copy-mode with a large scrollback (history-limit=50000).

• Stateless live/dormant model: a live session is any tmux window in the topencode session tagged with @oc_session/@oc_dir. Dormant = opencode session list minus live. No separate state file — state dies with the tmux objects, so closed windows and server restarts self-heal.
• Idempotent opens guarded by tmux wait-for locks: opening the same session twice selects the existing tab instead of duplicating.
• Auto-respawn: the zsh pane is tagged @oc_role=shell; a pane-died hook respawns only shell panes (never opencode), preserving the split.
• All tmux options are set on the topencode session only — your global tmux config is untouched.

• src/config.ts — constants & env overrides
• src/types.ts — shared interfaces
• src/tmux.ts — argv-based tmux driver (bootstrap, tabs, locks, hooks)
• src/opencode.ts — session list + live/dormant merge
• src/dashboard.ts — raw-ANSI + SGR-mouse two-column TUI
• bin/topencode.ts — CLI entry & routing

bun run dev list                # run from source
bun run src/dashboard.ts        # standalone dashboard self-test (fake data)
bun run typecheck               # tsc --noEmit
bun run build                   # dist/topencode single binary