Workflow Commands

Workflow Commands

Workflow commands provide high-level operations that combine multiple steps. These are the primary interface for day-to-day work with jjj.

jjj init

Initialize jjj in the current repository. Creates the .jjj/ metadata directory.

jjj init

jjj init

jjj submit

Submit current changes by rebasing onto main and squashing. Automatically accepts the solution and solves the problem when conditions are met.

jjj submit [OPTIONS]

Flag	Type	Description
--force	bool	Bypass critique and sign-off checks (sets force_accepted flag)

Submit performs these steps:

1. Checks for open critiques (unless --force).
2. Checks that all assigned reviewers have signed off (unless --force).
3. Rebases the current change onto main and squashes.
4. Auto-accepts the solution if it was in review or proposed status.
5. Auto-solves the problem if the accepted solution is the only active one and there are no open sub-problems.

Using --force bypasses the critique and sign-off gates and sets the force_accepted flag on the solution.

jjj submit
jjj submit --force

jjj status

Show status and next actions — what should I work on?

jjj status [OPTIONS]

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

Shows the active solution for the current jj change, next actions sorted by priority, and a summary of open problems, solutions in review, and open critiques.

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

jjj fetch

Fetch code and metadata from remote.

jjj fetch [OPTIONS]

Flag	Type	Description
--remote	string	Remote to fetch from (default: origin)

jjj fetch
jjj fetch --remote upstream

jjj push

Push code and metadata to remote.

jjj push [bookmarks...] [OPTIONS]

Flag	Type	Description
--remote	string	Remote to push to (default: origin)
--no-prompt	bool	Skip interactive prompts
--dry-run	bool	Show what would be pushed without pushing

jjj push
jjj push my-feature
jjj push --dry-run

jjj sync

Fetch from remote then push local changes back — shorthand for jjj fetch followed by jjj push.

jjj sync [OPTIONS]

Flag	Type	Description
--remote	string	Remote to sync with (default: origin)
--no-prompt	bool	Skip interactive prompts
--dry-run	bool	Show what would happen without making any changes

jjj sync
jjj sync --remote upstream
jjj sync --dry-run

jjj github

Bridge jjj problems and solutions with GitHub Issues and Pull Requests.

jjj github [COMMAND] [OPTIONS]

Flag	Type	Description
--dry-run	bool	Preview actions without making any changes

Subcommands

Command	Description
import [issue] [--all] [--label]	Import GitHub issue(s) as jjj problems
pr [solution] [--base]	Create or update a GitHub PR for a solution
status	Show sync status for all linked problems and solutions
merge <solution>	Squash-merge the linked GitHub PR for a solution
close <problem>	Close the linked GitHub issue for a problem
reopen <problem>	Reopen the linked GitHub issue for a problem

jjj github                          # pull review states from GitHub
jjj github import #123              # import issue #123 as a problem
jjj github import --all             # import all unlinked open issues
jjj github import --all --label bug # import issues with a specific label
jjj github pr                       # create PR for current solution
jjj github pr "auth fix" --base dev # create PR against a specific base branch
jjj github status                   # show linked issue/PR status
jjj github merge "auth fix"         # squash-merge the linked PR
jjj github close "old problem"      # close the linked GitHub issue

jjj ui

Launch the interactive TUI dashboard.

jjj ui

The TUI provides a visual interface for browsing problems, solutions, and their relationships.

jjj completion

Generate shell completions.

jjj completion <shell>

Supported shells: bash, zsh, fish, powershell, elvish.

jjj completion bash >> ~/.bashrc
jjj completion zsh >> ~/.zshrc
jjj completion fish > ~/.config/fish/completions/jjj.fish

jjj events

Query the decision event log.

jjj events [OPTIONS]

Flag	Type	Description
--from	string	Filter by start date (YYYY-MM-DD or YYYY-MM)
--to	string	Filter by end date
--problem	string	Filter by problem ID
--solution	string	Filter by solution ID
--type	string	Filter by event type
--search	string	Full-text search in rationales
--json	bool	Output as JSON
--limit	integer	Number of events (default: 20)

jjj events
jjj events --from 2024-01 --to 2024-06
jjj events --problem "auth"
jjj events --type solution_accepted
jjj events --search "cache"

jjj events rebuild

Rebuild events.jsonl from commit history.

jjj events validate

Validate event log against entity states.

jjj timeline

Show timeline for a problem and all related entities.

jjj timeline <problem> [OPTIONS]

Flag	Type	Description
--json	bool	Output as JSON

jjj timeline "auth bug"