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