tpc-explorer

TPC Explorer Pro

A terminal file explorer with embedded AI assistants, command palette, git integration, and multi-session support.

Install

npm install -g tpc-explorer
tpc

Or run directly:

npx tpc-explorer

Features

• File tree with syntax-highlighted preview, line numbers, and breadcrumb navigation
• Git integration — branch name in status bar, M/A/U/D indicators on changed files
• Embedded AI terminal — launch Claude Code or OpenAI Codex inside the explorer
• Multi-session — run multiple AI sessions simultaneously, switch with Ctrl+A
• Session history — browse and resume past Claude/Codex conversations
• Command palette (Ctrl+B) — git status, diff, log, branches, disk usage, package info, and more
• File search (Ctrl+F) — fuzzy find files across the project
• Welcome screen — ASCII logo with shortcuts and project info on startup
• Loading spinner when AI sessions start
• Copy path and Open in $EDITOR from the tree
• Tokyo Night Storm theme with emoji file-type icons (no Nerd Font needed)

Keyboard Shortcuts

Key	Action
Ctrl+B	Command palette (git, views, actions)
Ctrl+F	Search files
Ctrl+T	Switch panel (Tree / Sessions / Viewer)
Ctrl+A	Switch between active AI sessions
Ctrl+D	Kill all sessions and quit
a	Launch new AI (Claude Code / Codex)
n	New file
f	New folder
d	Delete file/folder
c	Copy file path to clipboard
e	Open in $EDITOR
r	Refresh tree, git status, and sessions
q / Esc	Quit

Inside AI session

Key	Action
Ctrl+C	Send interrupt to AI
Ctrl+C x2	Force kill active session
Ctrl+T	Switch to another panel (AI keeps running)
Ctrl+B	Open command palette

Layout

┌─ EXPLORER ──┬─────────── PREVIEW ───────────┐
│ file tree   │ breadcrumb path                │
│  with git   │ ─────────────────────          │
│  indicators │ syntax-highlighted content     │
│             │ or embedded AI terminal        │
├─ SESSIONS ──┤                                │
│ ◆ Claude    │                                │
│ ⊞ Codex     │                                │
├─────────────┴────────────────────────────────┤
│ Ctrl-T Switch │ Ctrl-B Cmds │ ⊙ main  Ctrl-D│
└──────────────────────────────────────────────┘

Command Palette

Press Ctrl+B to open. Available actions:

Actions — Launch AI, Switch Sessions, Search Files, New File/Folder, Delete, Copy Path, Open in Editor

Git — Status, Diff, Log (last 20), Branches, Stash List

View — Disk Usage, Package Info (parsed package.json with scripts, deps)

Requirements

• Node.js >= 18
• Build tools for native modules (node-pty):
  • macOS: Xcode Command Line Tools (xcode-select --install)
  • Linux: build-essential (sudo apt install build-essential)
  • Windows: windows-build-tools (npm install -g windows-build-tools)
• Optional: Claude Code and/or OpenAI Codex CLI installed

License

ISC