🚀 Claude Starter

Your homepage for Claude Code. All your sessions, at a glance.
Claude Code 的主页。你的所有会话，一目了然。

Built for AI-native developer workflows: local-first, searchable, resumable, and fast — so the next session starts faster than the last one ended.

npm install -g claude-starter  →  claude-starter

---

English

The Problem

Claude Code's /resume gives you a wall of UUIDs:

If you use Claude Code as part of a real development loop, session history stops being archive data and becomes working context. You need to find old agent work by repo, topic, and intent — not by opaque IDs.

? Select a conversation
  3ee0f33a-b882-424f-9ba4-260342e4dd5b - 4/3/2026, 10:53:41 AM
  87570bab-ee92-4681-9591-54abf2fcb486 - 4/3/2026, 10:18:55 AM
  ...200 more UUIDs...

Good luck finding that session where Claude fixed your auth bug last Tuesday.

The Solution

claude-starter

Beautiful split-pane UI with Tokyo Night colors. The left panel shows every session with project, time, and topic. The right panel previews the full conversation. Not UUIDs — your actual words.

claude-starter is built for developers treating coding agents as part of a daily workflow: keep everything local, cut resume friction, and make past conversations actually reusable.

🔍 Search — The Killer Feature

Press / and start typing. That's it. No Enter needed.

Searches across everything — project names, Git branches, conversation content. Results update as you type, ↑↓ to navigate instantly.

• auth → all auth-related sessions
• refactor → that cleanup from last week
• web-app fix → bug fixes in a specific project

No modes. No confirmation. Just type and go.

Features

	Feature	Description
🎨	Beautiful TUI	Tokyo Night color scheme, split-pane layout, feels native in your terminal
✨	New Session	Launch a fresh conversation in one keystroke
🔍	Instant Search	Fuzzy search across everything
📂	Project Filter	Press p to filter by project
⚡	One-Key Resume	Arrow, Enter, you're back in the conversation
📋	Session Preview	Full metadata + conversation history in the right panel
🔀	Sort Modes	Sort by time, size, messages, or project
📎	Copy ID	Press c to copy session ID
🔒	Permission Modes	Press m to configure, d for quick danger-mode resume
✏️	Rename Sessions	Press r to rename, supports CJK input
🗑️	Delete Sessions	Press x to remove unwanted sessions
⌨️	Vim Keybindings	j/k navigate, g/G jump to top/bottom
🧠	Smart CLI	Auto-detects mai-claude vs claude
🔐	100% Local	No network, no telemetry, no data leaves your machine

Install

npm install -g claude-starter

Or install from source:

git clone https://github.com/Bojun-Vvibe/claude-starter.git
cd claude-starter
npm install
npm link

Then run:

claude-starter

CLI Options

claude-starter              # Launch interactive TUI
claude-starter --list [N]   # Print latest N sessions (default: 30)
claude-starter --version    # Show version
claude-starter --update     # Update to the latest version
claude-starter --help       # Show help

Keyboard Shortcuts

Key	Action
↑ ↓ / j k	Navigate sessions
Enter	Start new / resume selected session
n	New session
d	Resume with bypassPermissions (danger mode)
m	Permission mode picker
r	Rename session
/	Search
Backspace	Edit search, auto-exit when empty
Esc	Clear filter
p	Filter by project
s	Cycle sort mode (time/size/messages/project)
c	Copy session ID
x / Delete	Delete session
g / G	Jump to top / bottom
Ctrl-D / Ctrl-U	Page down / up
q / Ctrl-C	Quit

How It Works

Reads the JSONL session files from ~/.claude/projects/, parses metadata and conversation content. 200 sessions load in ~10ms. Everything stays local. No API calls, no telemetry.

Requirements

• Node.js >= 18
• Claude Code (claude in PATH)

Related Projects

• codex-starter — the Codex counterpart with the same local-first workflow philosophy
• Bojun-Vvibe — more terminal UX and AI-native workflow experiments

License

MIT

---

中文

痛点

用过 Claude Code 的 /resume 吗？它给你的是这样一坨东西：

? Select a conversation
  3ee0f33a-b882-424f-9ba4-260342e4dd5b - 4/3/2026, 10:53:41 AM
  87570bab-ee92-4681-9591-54abf2fcb486 - 4/3/2026, 10:18:55 AM
  ...200 个 UUID...

一堆 UUID，没有上下文，无法搜索。想找到上周帮你调过 bug 的那个 session？祝你好运。

解决方案

Claude Starter 是一个精美的终端可视化工具，让你能像浏览网页一样浏览所有 Claude 历史会话。它是你的 Claude 主页 —— 每次打开终端，claude-starter 一敲，所有 session 一目了然。

claude-starter

精美的分屏 UI，Tokyo Night 配色。左侧列表一目了然，右侧实时预览对话详情。不是 UUID，是你真正说过的话。

🔍 搜索 — 杀手级功能

按 / 开始输入，就这么简单。无需按回车。

跨项目名、Git 分支、对话内容全文实时搜索。输入即过滤，↑↓ 直接导航结果。

• auth → 所有认证相关的对话
• refactor → 上周的代码重构
• web-app fix → 某个项目的 bug 修复

不需要管理模式，不需要确认。输入即搜，方向键即走。

核心能力

	功能	说明
🎨	精美 TUI	Tokyo Night 配色，分屏布局，终端里的 App
✨	一键新建	列表顶部直接新建对话
🔍	即时搜索	/ 全文搜索，无需回车
📂	项目过滤	p 按项目筛选
⚡	秒级恢复	选中 → Enter → 回到对话
📋	对话预览	右侧面板展示完整元数据和对话历史
🔀	多种排序	时间 / 大小 / 消息数 / 项目
📎	复制 ID	c 一键复制到剪贴板
🔒	权限模式	m 设置权限模式，d 一键 danger 模式恢复
✏️	重命名会话	r 直接重命名，支持中文输入
🗑️	删除会话	x 删除不需要的会话
⌨️	Vim 快捷键	j/k 上下，g/G 跳顶/底
🧠	智能 CLI	自动检测 mai-claude / claude
🔐	完全本地	不联网，不上传，不追踪

安装

npm install -g claude-starter

或者从源码安装：

git clone https://github.com/Bojun-Vvibe/claude-starter.git
cd claude-starter
npm install
npm link

然后运行 claude-starter，就这么简单。

CLI 参数

claude-starter              # 启动交互式 TUI
claude-starter --list [N]   # 打印最近 N 个会话（默认 30）
claude-starter --version    # 显示版本号
claude-starter --update     # 检查并更新到最新版本
claude-starter --help       # 显示帮助信息

快捷键

按键	功能
↑ ↓ / j k	上下导航
Enter	新建 / 恢复对话
n	直接新建
d	Danger 模式恢复（bypassPermissions）
m	权限模式选择器
r	重命名会话
/	搜索
Backspace	删除搜索字符，删空自动退出
Esc	清空搜索
p	按项目过滤
s	切换排序（时间/大小/消息数/项目）
c	复制 Session ID
x / Delete	删除会话
g / G	跳到顶 / 底
Ctrl-D / Ctrl-U	翻页
q / Ctrl-C	退出

原理

读取 ~/.claude/projects/ 下的 JSONL 会话文件，解析元数据和对话内容。200 个 session 加载耗时 ~10ms。所有数据留在本地，不联网。

---

_{Built with 💜 by Bojun — powered by Claude Code itself}