repokai-tui 0.2.1

A terminal UI for browsing and managing your GitHub repositories: rendered-markdown READMEs, mouse support, publish/clone/edit
repokai-tui-0.2.1 is not a library.

RepoKai

A GitHub repository browser and manager with both a terminal UI and a desktop GUI.

Features

  • Browse your GitHub repositories with a 3-panel layout
  • Toggle between your repositories and the repos you have starred
  • View README files, rendered: styled markdown with syntax-highlighted code blocks in the TUI, HTML in the GUI
  • Mouse support in the TUI: wheel-scroll the panel under the cursor, click to focus and select
  • View repo info: description, language, license, stars, visibility, last updated
  • Publish a local git repo to GitHub
  • Clone repos to your machine
  • Edit repo description and visibility
  • Open repos in your browser
  • 4 visual themes: Dark, Light, 3.1 (retro DOS), TUI (Tokyo Night)

Prerequisites

  • Git must be installed and available in your PATH
  • GitHub authentication is required. Either:
    • Set the GITHUB_TOKEN environment variable with a personal access token, or
    • Log in with the GitHub CLI: gh auth login

Installing

The terminal UI is on crates.io:

cargo install repokai-tui

This installs the repokai binary. The GUI is not packaged — run it from source (below).

Running from source

Terminal UI

cargo run -p repokai-tui

Desktop GUI

# Build the frontend first
cd crates/gui/ui && bun install && bun run build && cd -

# Run the app
cargo run -p repokai-gui

For hot-reload during development:

cd crates/gui && cargo tauri dev

Keyboard Shortcuts

Key Action
Up/Down or j/k Navigate repo list (auto-loads README)
Tab / Shift-Tab Switch panel (TUI)
Enter Reload README / open URL from info panel
j/k, PageUp/PageDown Scroll README
Mouse wheel Scroll the panel under the cursor (TUI)
Left click Focus panel, select repo or info field (TUI)
v Toggle view: my repos / starred
s Toggle sort: recent / a-z
r Refresh repo list
o Open repo in browser
p Publish local repo
c Clone selected repo
e Edit repo settings
t Cycle theme (GUI)
q/Esc Quit (TUI)

License

MIT