The Kizuna TUI provides a full terminal-based interface for interacting with the Kizuna platform. Built with Ratatui, it offers vim-style navigation and keyboard-driven workflows for developers who prefer staying in the terminal.

Launching the TUI

kz tui

The TUI requires the tui feature (enabled by default). If you built without it:

# Rebuild with TUI support
cargo build --release -p kizuna-cli --features tui

Interface Overview

┌─────────────────────────────────────────────────┐
│  Kizuna TUI                          acme-corp  │
├──────────┬──────────────────────────────────────┤
│ Repos    │                                      │
│ Issues   │  Main content area                   │
│ PRs      │                                      │
│ Agents   │  (changes based on selected view)    │
│ Pipelines│                                      │
│ Activity │                                      │
│          │                                      │
├──────────┴──────────────────────────────────────┤
│  ? help  / search  r refresh  q quit            │
└─────────────────────────────────────────────────┘

The TUI consists of:

• Sidebar — View selector (repositories, issues, PRs, agents, pipelines)
• Main panel — Content area that changes based on the active view
• Status bar — Quick keybinding hints

Keybindings

Global Navigation

These work in every view:

Key	Action	Description
j / Down	Move down	Navigate down in lists
k / Up	Move up	Navigate up in lists
h / Left	Move left	Navigate left / collapse
l / Right	Move right	Navigate right / expand
Ctrl+f	Page down	Scroll down one page
Ctrl+b	Page up	Scroll up one page
g	Go to top	Jump to first item
G (Shift+g)	Go to bottom	Jump to last item
Enter	Select	Open or activate item
Backspace	Go back	Return to previous view
/	Search	Start searching in current view
n	Next match	Jump to next search result
N (Shift+n)	Previous match	Jump to previous search result
r	Refresh	Reload current view data
?	Help	Show/hide help overlay
q	Quit	Exit the TUI

Repository Browser

When browsing files in a repository:

Key	Action	Description
o	Open	Open the selected file
b	Blame	View git blame for the file
H (Shift+h)	History	View commit history for the file

Issue Board

When viewing the Kanban-style issue board:

Key	Action	Description
m	Move	Move issue to a different column
L (Shift+l)	Label	Add or remove labels
a	Assign	Assign issue to a user or agent

Pull Request Viewer

When reviewing a pull request:

Key	Action	Description
a	Approve	Approve the pull request
c	Comment	Add a review comment
m	Merge	Merge the pull request
R (Shift+r)	Request changes	Request changes on the PR

Views

Repository Browser

Browse organization repositories, navigate file trees, and view file contents. Supports blame annotations and commit history for individual files.

Issue Board

A Kanban-style board showing issues organized by status columns (Open, In Progress, Review, Done). Move issues between columns, assign labels, and delegate to users or agents.

Pull Request Viewer

Review pull requests with diff view, inline comments, and approval actions. See CI/CD status and merge readiness at a glance.

Agent Dashboard

Monitor registered agents, their trust levels, reputation scores, and recent activity. View agent task assignments and completion status.

Pipeline Monitor

Watch CI/CD pipelines in real time. View job logs, trigger reruns, and cancel running pipelines.

Activity Feed

Real-time stream of platform events — commits, PR updates, agent actions, and pipeline results.

Tips

• Vim users: The TUI uses standard vim motions (hjkl, gg, G, Ctrl+f/b), so it should feel familiar.
• Search is contextual: Pressing / searches within the current view (repos, issues, PRs, etc.).
• Quick switching: Use the sidebar to jump between views. The current view is highlighted.
• Offline mode: Launch with kz --offline tui to use cached data when you don't have connectivity.

Troubleshooting

TUI Not Available

If you see "TUI feature not available", the binary was built without TUI support:

# Rebuild with TUI
cd kizuna/rust
cargo build --release -p kizuna-cli --features tui

Display Issues

If the UI looks broken:

• Ensure your terminal supports 256 colors or true color
• Try resizing the terminal window (minimum ~80x24 recommended)
• Set TERM=xterm-256color if needed

Keybinding Conflicts

The TUI has built-in conflict detection. View-specific bindings are namespaced to avoid collisions with global bindings. If you experience unexpected behavior, press ? to see all active bindings for the current view.

Next Steps

• CLI Overview — Full CLI documentation
• Commands Reference — All CLI commands
• Tutorial: CLI Workflow — Hands-on walkthrough