claude-starter

skill
Guvenlik Denetimi
Basarisiz
Health Uyari
  • No license — Repository has no license file
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 13 GitHub stars
Code Basarisiz
  • child_process — Shell command execution capability in index.js
  • execSync — Synchronous shell command execution in index.js
  • fs.rmSync — Destructive file system operation in index.js
  • os.homedir — User home directory access in index.js
  • process.env — Environment variable access in index.js
  • fs module — File system access in index.js
  • child_process — Shell command execution capability in test-tui.js
  • execSync — Synchronous shell command execution in test-tui.js
  • fs.rmSync — Destructive file system operation in test-tui.js
  • os.homedir — User home directory access in test-tui.js
  • fs module — File system access in test-tui.js
  • child_process — Shell command execution capability in test.js
  • execSync — Synchronous shell command execution in test.js
  • fs.rmSync — Destructive file system operation in test.js
  • os.homedir — User home directory access in test.js
  • fs module — File system access in test.js
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This tool provides a visual, terminal-based interface for managing and searching local Claude Code sessions. It replaces the default UUID-based session list with a readable, searchable split-pane UI.

Security Assessment
Risk Rating: Medium

The tool extensively uses synchronous shell command execution (`execSync`) to interact with your system. It accesses the user's home directory (`os.homedir`) and reads environment variables, which is necessary to locate and read local Claude Code conversation files. It also performs destructive file system operations (`fs.rmSync`), which could be dangerous if manipulated or if a bug exists. No hardcoded secrets or outbound network requests were detected, meaning all processing is handled locally on your machine.

Quality Assessment
The project is actively maintained, with its most recent push occurring today. It claims an MIT license in the README badges, though the automated scan failed to find an actual license file in the repository, creating a minor legal ambiguity. Community trust is currently low but growing, sitting at 13 GitHub stars. As an open-source local utility, it provides a solid foundation for developer workflows, but the lack of a formally committed license file is an oversight.

Verdict
Use with caution — it is locally contained and actively updated, but developers should review the shell execution and file deletion logic before installing.
SUMMARY

A beautiful terminal UI for Claude Code sessions — built for local-first, AI-native developer workflows.

README.md

Claude Starter
npm Node.js MIT License Release Platform

🚀 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

Claude Starter Screenshot


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

Yorumlar (0)

Sonuc bulunamadi