repokai-core 0.2.1

GitHub API layer for RepoKai: fetch your repositories and READMEs, publish, clone, and edit repos (octocrab-based)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# 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](https://cli.github.com): `gh auth login`

## Installing

The terminal UI is on [crates.io](https://crates.io/crates/repokai-tui):

```bash
cargo install repokai-tui
```

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

## Running from source

### Terminal UI

```bash
cargo run -p repokai-tui
```

### Desktop GUI

```bash
# 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:

```bash
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