Skip to content

ckluis/terminalHelper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

th — Terminal Helper

A terminal command reference that keeps your CLI knowledge organized and searchable. Browse tools by category, search across commands, or ask Claude to explain any terminal task.

Built for people who want to learn and remember terminal commands without digging through man pages.

Features

  • Miller column TUI — Browse tools organized by category, with instant command previews
  • Full-text search — SQLite FTS5 search across all tools and commands
  • Ask Claude — Ask a question in plain English, get runnable commands back, save them to your library
  • Clipboard support — Copy any command with a keypress
  • Starter library — Ships with git, curl, and other essentials so it's useful immediately
  • Export — Dump any tool as JSON for sharing or backup

Install

Requires Go 1.21+ and optionally Claude Code for the ask feature.

git clone https://github.com/ckluis/terminalHelper.git
cd terminalHelper
go build -o th .

Move th somewhere in your $PATH:

mv th /usr/local/bin/

Usage

th                          Launch TUI (browse tools by category)
th ask "question"           Ask Claude about a terminal task
th search <query>           Search across all tools and commands
th export <tool>            Export a tool as JSON
th doctor                   Check your setup
th --help                   Show help
th --version                Show version

TUI keybindings

Key Action
/ or k/j Navigate items
/ or h/l Switch columns
Enter Select / expand
/ Search filter
c Copy command
Ctrl-A Ask Claude
? Help
Esc Back
q Quit

How it works

th stores your command library in a local SQLite database with FTS5 full-text search. On first run it seeds a starter library so you have something to browse immediately.

The ask command shells out to claude --print — no API keys needed. Claude returns structured JSON with tool names, commands, descriptions, and safety warnings. You can save any answer directly to your library.

Configuration

Set TH_DB to customize the database location:

export TH_DB=~/my-commands.db

Tech stack

Component Choice
Language Go
TUI Bubbletea + Lipgloss
Storage SQLite (via modernc.org/sqlite)
Search SQLite FTS5
AI Claude Code CLI (claude --print)
Clipboard atotto/clipboard

License

See LICENSE.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages