kajji

A terminal UI for jj / Jujutsu: navigate changes, inspect polished diffs, and run common jj workflows with ease and speed.

Kajji gives jj a fast, keyboard-first interface with a commit graph, file tree, operation log, bookmark management, GitHub helpers, revset filtering, and custom diff rendering with syntax highlighting, word-level emphasis, split/unified layouts, wrapping, and binary-file handling.

# recommended if you use Homebrew
brew install eliaskc/tap/kajji

# standalone binary installer, no package manager required
curl -fsSL https://kajji.sh/install.sh | bash

# or via JavaScript package manager
npm install -g kajji
bun install -g kajji
pnpm add -g kajji
yarn global add kajji

# or run directly without installing
npx kajji
bunx kajji

To remove kajji and its config/data:

kajji uninstall                       # interactive: removes config, data, and the binary
kajji uninstall --dry-run             # show what would be removed
kajji uninstall --keep-config --keep-data
kajji uninstall --force               # skip the confirmation prompt

Requirements: Bun

git clone https://github.com/eliaskc/kajji.git
cd kajji
bun install
bun dev

Run kajji in any jj repository:

kajji                    # current directory
kajji /path/to/repo      # specific directory

Kajji has two main viewing modes:

• Normal mode keeps the log, bookmarks, detail, and command log visible.
• Diff focus mode gives the detail pane more space for side-by-side diffs.

Toggle between them with ctrl+x.

jj workflows

• Commit log with graph and revset filtering
• File view with tree/list toggle, editor launching, and discard for working-copy files
• New, edit, describe, squash, abandon, duplicate, rebase, split, resolve
• Undo, redo, operation log, and restore
• Bookmark create/delete/rename/forget/set/move plus remote-only filtering
• Git fetch/push menus
• Open commits and PRs on GitHub
• Recent repository switcher

Diff viewing

• Custom unified and split diff renderers
• Syntax highlighting and word-level change emphasis
• Line wrapping and horizontal scrolling
• Hunk and file navigation
• Optional jj formatter output
• Binary file detection

TUI polish

• Vim-style navigation plus mouse support
• Focusable panels and tabs
• Command palette with fuzzy search (? / ctrl+p)
• Context-aware status hints
• JSONC config with schema autocomplete
• Automatic update notifications

Kajji includes a small CLI for scripting and agent workflows:

# List changes with addressable hunk IDs
kajji changes -r @

# Comments
kajji comment list -r @
kajji comment set -r @ --hunk h1 -m "note"
kajji comment set -r @ --file src/App.tsx --line 12 -m "note"
kajji comment delete -r @ --hunk h1
kajji comment delete -r @ --file src/App.tsx --line 12
kajji comment delete -r @ --file src/App.tsx
kajji comment delete -r @ --all -y

Kajji reads JSONC config from ~/.config/kajji/config.json (comments and trailing commas are supported).

• Open it from the command palette (?) with open config
• Changes made through open config are reloaded when you return to kajji
• The default config includes $schema: "https://kajji.sh/schema.json" for editor autocomplete

Common settings include:

• ui.themeMode: system, dark, or light
• ui.syntaxTheme.dark / ui.syntaxTheme.light: syntax highlighting theme names
• ui.showFileTree: show files as a tree or flat list
• diff.layout: auto, unified, or split
• diff.autoSwitchWidth: terminal width where auto switches to split view
• diff.wrap: wrap long diff lines
• diff.useJjFormatter: use jj's configured diff formatter in the detail pane
• gitHooksPath: default Git-compatible hooks directory to check for pre-commit before jj.new (.git/hooks enables standard per-repo Git hooks in every repo)
• repos: repo-specific gitHooksPath and operation hooks keyed by repository path
• whatsNewDisabled / autoUpdatesDisabled: update notification controls

Default keybindings are contextual. Press ? or ctrl+p in kajji for the full command list available in the current panel.

• OpenTUI + SolidJS - TypeScript TUI framework
• Bun - JavaScript runtime and build tooling
• jj (Jujutsu) - Git-compatible VCS

• lazygit - Git TUI
• jjui - Go-based jj TUI
• lazyjj - Rust-based jj TUI

MIT