Note: This is an independent, community-maintained project created by fans of OpenCode. We are not affiliated with SST Corp. or the official OpenCode project. For the official OpenCode CLI, visit opencode.ai.

Terminal UI for inspecting, filtering, and pruning OpenCode metadata stored on disk. The app is written in TypeScript, runs on Bun, and renders with @opentui/react.

Main workspace with Projects (left) and Sessions (right) panels.

Contextual help overlay with key bindings and tips.

• List both OpenCode projects and sessions from a local metadata root.
• Filter by "missing only", bulk-select, and delete metadata safely.
• Jump from a project directly to its sessions and keep contextual filters.
• Global search bar (/ to focus, Enter to apply, Esc or X to clear).
• Rename sessions inline (Shift+R) with title validation.
• Move sessions between projects (M) preserving session ID.
• Copy sessions to other projects (P) with new session ID generation.
• Rich help overlay with live key hints (? or H).
• Zero-install via bunx so even CI shells can run it without cloning.
• Token counting: View token usage per session, per project, and globally.

The TUI displays token telemetry from OpenCode's stored message data at three levels:

1. Per-session: Shows a breakdown in the session Details pane (Input, Output, Reasoning, Cache Read, Cache Write, Total).
2. Per-project: Shows total tokens for the highlighted project in the Projects panel.
3. Global: Shows total tokens across all sessions in the header bar.

• Token data is read from storage/message/<sessionId>/*.json files (assistant messages only).
• If token telemetry is missing or unreadable, the display shows ? instead of 0.
• Token summaries are cached in memory and refreshed when you press R to reload.
• Large datasets are handled with lazy computation to avoid UI freezes.

• Bun 1.1.0+ (developed/tested on 1.2.x).
• A node-compatible terminal (truecolor improves readability but is optional).

# Clone the repo and install deps
git clone git@github.com:kcrommett/oc-manager.git
cd oc-manager
bun install

# Or run on demand without cloning
bunx opencode-manager --help

The repository ships with a focused .gitignore, keeping node_modules/, caches, and logs out of Git history.

# Preferred: zero-install command
bunx opencode-manager --root ~/.local/share/opencode

# Local dev run (forwards extra args after --)
bun run tui -- --root ~/.local/share/opencode

# Legacy Python wrapper (still used by some automation)
./manage_opencode_projects.py --root ~/.local/share/opencode -- --help

Keyboard reference:

• Global: Tab/1/2 switch tabs, / search, X clear search, R reload, Q quit, ? help.
• Projects: Space toggle selection, A select all, M missing-only filter, D delete, Enter jump to Sessions.
• Sessions: Space select, S toggle sort, D delete, Y copy ID, Shift+R rename, M move to project, P copy to project, C clear filter.

1. Install dependencies with bun install.
2. Run the TUI via bun run tui (pass storage flags after --).
3. Use bun run dev for watch mode.
4. Type-check with bun run typecheck (tsc --noEmit).

src/
  bin/opencode-manager.ts   # Bun-native CLI shim exposed as the bin entry
  opencode-tui.tsx          # Main TUI implementation (panels, search, help)
manage_opencode_projects.py # Legacy Python launcher for backwards compatibility
opencode-gen.sh             # Spec snapshot helper script
PROJECT-SUMMARY.md          # Extended design notes & roadmap

1. bun install
2. bun run typecheck
3. Update version in package.json
4. npm publish (package exposes the opencode-manager bin with public access)

• tmux failures: Some sandboxed environments block tmux sockets under /tmp. Run bun run tui directly if tmux refuses to start.
• Rendering glitches: OpenTUI expects all textual content inside <text> nodes. When adding UI components, follow the existing helpers (e.g., KeyChip, Bullet).
• Search won’t clear: Press Esc while the search bar is focused, or hit X while in normal navigation.

Issues and pull requests are welcome. Please include reproduction steps for metadata edge cases and run bun run typecheck before submitting patches.

MIT © OpenCode contributors. See LICENSE.