Kavi

Views

Deep dive into each of the 9 TUI views in the Kavi operator console

Switch between views using number keys 1 through 9. Each view provides a focused perspective on your session.

1. Activity

The default view. Shows the session as a chronological progress log with tone markers:

  • Normal: Standard events
  • Good: Successful completions
  • Warn: Potential issues or attention needed
  • Bad: Errors or failures
  • Muted: Background or low-priority events

2. Results

Displays unified agent outputs and the execution plan visualization. After a planning pass, you'll see the materialized DAG with task dependencies and their status.

When a task completes, its summary and structured output appear here.

3. Tasks

A task board showing all session tasks with:

  • Task status (pending, running, completed)
  • Assigned agent (codex/claude)
  • Dependency relationships
  • Summaries and artifact availability

Use j/k to navigate tasks, [ and ] to cycle detail sections, , and . to cycle changed files, and {/} to cycle patch hunks.

4. Recommendations

Shows Kavi's smart suggestions:

  • Handoff: When one agent should pass work to another
  • Integration: When overlapping changes need conflict resolution
  • Ownership config: When routing rules should be updated

Actions: Enter to apply, P to force follow-up, z to dismiss, Z to restore.

5. Approvals

The approval inbox shows pending tool-use requests from both agents. Each entry shows the tool name, arguments, and requesting agent.

Actions: y to approve, n to deny.

6. Claims

Displays the active path claim map — which agent has claimed which file paths. Highlights:

  • Hotspots: Files with overlapping claims from multiple agents
  • Ownership conflicts: Routing rules that don't produce clear winners
  • Recommendation-driven next actions for resolving conflicts

7. Decisions

A complete audit trail of all decisions made during the session:

  • Routing decisions: Which agent was chosen and why
  • Approval decisions: What was approved or denied
  • Task decisions: Planning and scheduling choices
  • Integration decisions: Merge and landing outcomes

8. Messages

Peer-to-peer messages between agents. Each message carries a structured intent:

  • question — Seeking clarification
  • handoff — Requesting work transfer
  • review_request — Asking for review
  • blocked — Notifying of blockers
  • context_share — Sharing useful context

9. Worktrees

Shows the git state of each agent's worktree:

  • Branch name and path
  • Changed files with diff status
  • Diff content viewable with navigation keys

Review Controls

From the Tasks view (3), you can add review notes to diffs:

  • A — Add an approve note
  • C — Add a concern
  • Q — Add a question
  • M — Add a general note
  • o/O — Cycle existing threads
  • T — Reply to a thread
  • E — Edit a note
  • R — Resolve or reopen a thread
  • a — Cycle thread assignee
  • w — Mark as won't-fix
  • x — Mark as accepted-risk
  • F — Queue a fix task from a thread
  • H — Queue a handoff task

Review Filters

Use these keys to filter the review context:

  • u — Cycle assignee filter
  • v — Cycle status filter
  • d — Cycle disposition filter

On this page