TUI and Status

TUI and Status

jjj provides two views for understanding your project’s state: the TUI shows an interactive view of next actions and the project tree, and status shows your personal context and prioritized next actions on the command line.

The TUI

Launch the interactive terminal UI:

jjj ui

The TUI provides two panes:

The TUI shows a Project Tree on the left and a Detail pane on the right. Use Tab to jump to the next action item in the tree.

Items are grouped by urgency:

Category	Meaning
BLOCKED	Solutions blocked by open critiques
READY	Solutions ready to approve (critiques resolved)
REVIEW	Solutions waiting for your review
WAITING	Solutions in review, waiting on others
TODO	Open problems without solutions yet

Project Tree (left pane) — A hierarchical view of the project:

Milestones
├── 01957d: Q1 Release
│   ├── 01958a: Search is slow [open]
│   │   └── 01958b: Add search index [review]
│   │       └── 01958c: Missing error handling [open]
│   └── 01958d: Login fails [solved]
└── Backlog
    └── 01958e: Add dark mode [open]

TUI Navigation

Key	Action
Tab	Jump to next action
S-Tab	Jump to previous action
↑/↓	Navigate items
←/→	Collapse / expand tree node
j/k	Scroll detail pane
Space	Page down in detail
f	Toggle filter (full / actions only)
R	Toggle related view
a	Approve solution / Address critique
r	Withdraw solution
u	Submit solution for review
d	Dismiss critique
v	Validate critique
o	Reopen problem
D	Dissolve problem (with reason)
A	Assign to me
e	Edit title
E	Edit in $EDITOR
n	New (solution for problem, critique for solution)
g	Go to solution’s jj change
/	Search / filter
?	Show all key bindings
q	Quit

Status

The status command shows your personal context on the command line: the active solution for your current change, prioritized next actions, and a summary of project health.

Viewing Status

jjj status

Output:

Active: s/01959a "Add Redis caching" -> p/01958f [review]
  Open critiques: 2
    c/01959b: Cache invalidation not handled [high]
    c/01959c: Redis single point of failure [medium]

Next actions:

1. [BLOCKED] s/01959a: Add Redis caching -- 2 open critique(s)
   c/01959b: Cache invalidation not handled [high]
   c/01959c: Redis single point of failure [medium]
   -> jjj critique show "invalidation"

2. [TODO] p/01959d: API rate limiting needed -- No solutions proposed
   -> jjj solution new "title" --problem "rate limiting"

Summary: 4 open problems, 3 in review, 5 open critiques

Status Flags

Flag	Description
--all	Show all items (no limit)
--mine	Only show your authored work
--limit N	Show top N items (default: 5)
--json	Output as JSON

jjj status --all
jjj status --mine --limit 10
jjj status --json

Acting on Status

1. Open critiques? Address them first. They are blocking your solutions.

   jjj critique show "invalidation"
   # Understand the concern, then address, dismiss, or validate
   jjj critique address "invalidation"

2. Solutions in review? Address critiques or wait for reviewer sign-off.

   jjj solution new "title" --problem "search slow" --reviewer @bob

3. Problems assigned but no solutions? Propose a solution.

   jjj solution new "Rate limit with token bucket algorithm" --problem "rate limiting"

4. Nothing assigned? Claim the top item in one step:

   jjj next --claim

   Or run jjj status --all to see all items across the project.

Overlap Warnings

When multiple active solutions touch the same files, jjj status shows a warning:

⚠ 2 files touched by multiple active solutions:
  src/auth/handler.rs — Add OAuth, Fix token refresh
  src/auth/config.rs — Add OAuth, Fix token refresh

Run jjj overlaps for the full detail, or jjj overlaps --json for structured output.

Combining TUI and Status

• Quick check: Use jjj status for a command-line summary
• Interactive work: Use jjj ui for browsing and taking actions
• Scripting: Use jjj status --json for automation
• Grab work: Use jjj next --claim to pick up the top item
• Project health: Use jjj insights for aggregate statistics

Next Steps

• Problem Solving — Creating and managing problems
• Critique Guidelines — Working with critiques
• Code Review — The reviewer workflow