Problem Commands

Problem Commands

Problems represent what needs to be solved. They can be organized hierarchically with parent-child relationships and assigned to milestones.

Entity Resolution

All commands that take a problem ID support multiple resolution methods:

• Fuzzy title match: "App crashes" or "auth module" — matches against problem titles
• Truncated prefix: 01957d — minimum 6 hex characters from the UUID
• Full UUID: 01957d3e-a8b2-7def-8c3a-9f4e5d6c7b8a

If multiple entities match, an interactive picker appears (TTY) or suggestions are shown (non-TTY).

jjj problem new

Create a new problem.

jjj problem new <title> [OPTIONS]

Flag	Type	Default	Description
--priority	string	medium	Priority: critical, high, medium, low
--parent	string		Parent problem (title, prefix, or UUID)
--milestone	string		Milestone to target (title, prefix, or UUID)
--tags	string		Comma-separated tags (e.g., backend,auth,size:L)
--force, -f	flag		Create even if a similar problem already exists

jjj init
jjj problem new "App crashes on startup" --priority high
jjj problem new "Null pointer in auth module" --parent "App crashes"
jjj problem new "Improve test coverage"

jjj problem list

List all problems.

jjj problem list [OPTIONS]

Flag	Type	Description
--status	string	Filter by status (open, in_progress, solved, dissolved)
--tree	bool	Show hierarchical tree view
--milestone	string	Filter by milestone
--search	string	Search problems by title text
--tag	string	Filter by tag (case-insensitive exact match)
--json	bool	Output in JSON format

jjj problem list
jjj problem list --status open
jjj problem list --tree
jjj problem list --json

jjj problem show

Show problem details.

jjj problem show <problem> [OPTIONS]

Flag	Type	Description
--json	bool	Output in JSON format

jjj problem show "App crashes"
jjj problem show "App crashes" --json

jjj problem edit

Edit problem details.

jjj problem edit <problem> [OPTIONS]

Flag	Type	Description
--title	string	New title
--status	string	New status (open, in_progress, solved, dissolved)
--priority	string	Set priority: critical, high, medium, low
--parent	string	Set parent problem
--add-tag	string	Add a tag
--remove-tag	string	Remove a tag

jjj problem edit "App crashes" --title "App crashes on cold startup" --priority critical

jjj problem tree

Show problem hierarchy as a tree.

jjj problem tree [problem]

If no problem is given, shows all root problems and their children.

jjj problem tree
jjj problem tree "App crashes"

jjj problem solve

Mark a problem as solved. Requires an approved solution.

jjj problem solve <problem>

jjj problem solve "App crashes"

jjj problem dissolve

Mark a problem as dissolved (based on false premises).

jjj problem dissolve <problem> [OPTIONS]

Flag	Type	Description
--reason	string	Reason for dissolving

jjj problem dissolve "test coverage" --reason "Turned out to be expected behavior"

jjj problem reopen

Transition a solved or dissolved problem back to open.

jjj problem reopen <problem>

Useful when a previously solved problem recurs or a dissolved problem turns out to be real after all.

jjj problem reopen "App crashes"

jjj problem graph

Render the problem hierarchy as an ASCII DAG (directed acyclic graph).

jjj problem graph [OPTIONS]

Flag	Type	Description
--all	flag	Include solved and dissolved problems (default: active only)
--milestone	string	Filter to problems in a specific milestone

By default only open and in-progress problems are shown. Use --all to include solved (◉) and dissolved (×) problems.

jjj problem graph
jjj problem graph --all
jjj problem graph --milestone "Q1 Release"

Example output:

○ Authentication system [open]
├─ ○ Login flow [in_progress]
│  └─ ○ OAuth2 integration [open]
└─ ○ Session management [open]
○ Performance monitoring [open]
└─ ○ Request latency tracking [open]

Icons: ○ open/in-progress, ◉ solved, × dissolved.

jjj problem assign

Assign a problem to a person.

jjj problem assign <problem> [OPTIONS]

Flag	Type	Description
--to	string	Assignee name (defaults to self)

jjj problem assign "App crashes" --to alice