Command reference

jj --repository PATH ...

Open a repository without changing shell directories.

In jk

jk -R PATH

Options

-R --repository

Result

All native views use the selected repository.

• The repository flag is a top-level jk option; supply it before a subcommand.

Read the workflow → · Recording

jj root; jj workspace list

Find a child workspace when the repository root has no working copy.

In jk

jk from a no-working-copy container

Result

The resolver intends to select the default child, otherwise the lexicographically first child. With tested jj 0.45.1, its exact diagnostic check misses No working copy. (with a period), so automatic selection fails and startup lacks the intended working-copy context.

• Known defect UX-18: automatic child selection fails with the No working copy. diagnostic emitted by tested jj 0.45.1. Use an explicit repository path.
• A sibling workspace outside the container is not selected automatically.

Read the workflow → · Recording · UX-18

jk --dialog-theme auto|dark|light

Keep dialogs readable against the terminal.

In jk

jk --dialog-theme dark

Options

auto dark light

Result

Changes jk dialog surfaces; jj controls its own repository output colors.

Read the workflow → · Recording

jj

See the repository using its jj default command and template.

In jk

jk

Result

Renders jj output and uses a separate semantic pass for stable navigation.

Affects

working-copy snapshot

• The configured default must be log-like and accept the semantic template query.

Read the workflow → · Recording

jj log

Open log even when the configured home command differs.

In jk

jk log

L

Result

Shows the explicit log; H returns to the configured home view.

Affects

working-copy snapshot

Read the workflow → · Recording

jj [log] -n LIMIT

Keep the initial graph bounded.

In jk

jk -n LIMIT

jk log -n LIMIT

Options

-n --limit

Result

Subcommand limit takes precedence over top-level limit.

Read the workflow → · Recording

jj log

Choose the amount of detail visible per change.

In jk

V → Template → configured

Result

Only rendered text changes; semantic revision navigation remains stable.

Read the workflow → · Recording

jj log -T builtin_log_comfortable

Choose the amount of detail visible per change.

In jk

V → Template → comfortable

Options

-T --template

Result

Only rendered text changes; semantic revision navigation remains stable.

Read the workflow → · Recording

jj log -T builtin_log_compact

Choose the amount of detail visible per change.

In jk

V → Template → compact

Options

-T --template

Result

Only rendered text changes; semantic revision navigation remains stable.

Read the workflow → · Recording

jj log -T builtin_log_compact_full_description

Choose the amount of detail visible per change.

In jk

V → Template → full description

Options

-T --template

Result

Only rendered text changes; semantic revision navigation remains stable.

Read the workflow → · Recording

jj log -T builtin_log_detailed

Choose the amount of detail visible per change.

In jk

V → Template → detailed

Options

-T --template

Result

Only rendered text changes; semantic revision navigation remains stable.

Read the workflow → · Recording

jj log -T builtin_log_oneline

Choose the amount of detail visible per change.

In jk

V → Template → oneline

Options

-T --template

Result

Only rendered text changes; semantic revision navigation remains stable.

Read the workflow → · Recording

jj log -T builtin_log_redacted

Choose the amount of detail visible per change.

In jk

V → Template → redacted

Options

-T --template

Result

Only rendered text changes; semantic revision navigation remains stable.

Read the workflow → · Recording

jj log -T TEMPLATE

Choose the amount of detail visible per change.

In jk

jk log -T TEMPLATE

Options

-T --template

Result

Only rendered text changes; semantic revision navigation remains stable.

• Custom is selectable only after starting jk log -T TEMPLATE.

Read the workflow → · Recording

jj log -r ELISION_REVSET

Reveal revisions hidden by the current graph.

In jk

Enter or Right on a ~ row

Result

Pushes a drill-down graph; Left or Backspace returns to the previous graph.

• This is an elision action, not an arbitrary revset input.

Read the workflow → · Recording

jj diff -r REV

Review a change against its parent.

In jk

d from log

V → patch

Options

-r --revision positional REV alias

Result

Displays jj patch output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• Known defect UX-17: hunk controls do not work with ordinary jj output. File navigation depends on the configured diff format; Git-format output is not parsed into files.

Read the workflow → · Recording · UX-16 · UX-17

jj diff -r REV --summary

Review a change against its parent.

In jk

d from log

V → summary

Options

-r --revision positional REV alias --summary

Result

Displays jj summary output with navigation appropriate to the rendered format.

• No native diff fileset operand.

Read the workflow → · Recording · UX-16

jj diff -r REV --stat

Review a change against its parent.

In jk

d from log

V → stat

Options

-r --revision positional REV alias --stat

Result

Displays jj stat output with navigation appropriate to the rendered format.

• No native diff fileset operand.

Read the workflow → · Recording · UX-16

jj diff -r REV --types

Review a change against its parent.

In jk

d from log

V → types

Options

-r --revision positional REV alias --types

Result

Displays jj types output with navigation appropriate to the rendered format.

• No native diff fileset operand.

Read the workflow → · Recording · UX-16

jj diff -r REV --name-only

Review a change against its parent.

In jk

d from log

V → name-only

Options

-r --revision positional REV alias --name-only

Result

Displays jj name-only output with navigation appropriate to the rendered format.

• No native diff fileset operand.

Read the workflow → · Recording · UX-16

jj diff -r REV --git

Review a change against its parent.

In jk

d from log

V → git

Options

-r --revision positional REV alias --git

Result

Displays jj git output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• Known defect UX-17: hunk movement and folding are ineffective for this output format. Git-format output also lacks parsed file navigation and file folding.

Read the workflow → · Recording · UX-16 · UX-17

jj diff -r REV --color-words

Review a change against its parent.

In jk

d from log

V → color-words

Options

-r --revision positional REV alias --color-words

Result

Displays jj color-words output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• Known defect UX-17: hunk movement and folding are ineffective for this output format. File navigation and file folding work for recognized regular-file sections.

Read the workflow → · Recording · UX-16 · UX-17

jj diff --from FROM --to TO

Review the tree difference between two explicit revisions.

In jk

jk diff --from FROM --to TO

V → patch

Options

--from --to

Result

Displays jj patch output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• FROM and TO must be supplied together; revision form cannot be combined with them.
• Known defect UX-17: hunk controls do not work with ordinary jj output. File navigation depends on the configured diff format; Git-format output is not parsed into files.

Read the workflow → · Recording · UX-04 · UX-16 · UX-17

jj diff --from FROM --to TO --summary

Review the tree difference between two explicit revisions.

In jk

jk diff --from FROM --to TO

V → summary

Options

--from --to --summary

Result

Displays jj summary output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• FROM and TO must be supplied together; revision form cannot be combined with them.

Read the workflow → · Recording · UX-04 · UX-16

jj diff --from FROM --to TO --stat

Review the tree difference between two explicit revisions.

In jk

jk diff --from FROM --to TO

V → stat

Options

--from --to --stat

Result

Displays jj stat output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• FROM and TO must be supplied together; revision form cannot be combined with them.

Read the workflow → · Recording · UX-04 · UX-16

jj diff --from FROM --to TO --types

Review the tree difference between two explicit revisions.

In jk

jk diff --from FROM --to TO

V → types

Options

--from --to --types

Result

Displays jj types output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• FROM and TO must be supplied together; revision form cannot be combined with them.

Read the workflow → · Recording · UX-04 · UX-16

jj diff --from FROM --to TO --name-only

Review the tree difference between two explicit revisions.

In jk

jk diff --from FROM --to TO

V → name-only

Options

--from --to --name-only

Result

Displays jj name-only output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• FROM and TO must be supplied together; revision form cannot be combined with them.

Read the workflow → · Recording · UX-04 · UX-16

jj diff --from FROM --to TO --git

Review the tree difference between two explicit revisions.

In jk

jk diff --from FROM --to TO

V → git

Options

--from --to --git

Result

Displays jj git output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• FROM and TO must be supplied together; revision form cannot be combined with them.
• Known defect UX-17: hunk movement and folding are ineffective for this output format. Git-format output also lacks parsed file navigation and file folding.

Read the workflow → · Recording · UX-04 · UX-16 · UX-17

jj diff --from FROM --to TO --color-words

Review the tree difference between two explicit revisions.

In jk

jk diff --from FROM --to TO

V → color-words

Options

--from --to --color-words

Result

Displays jj color-words output with navigation appropriate to the rendered format.

• No native diff fileset operand.
• FROM and TO must be supplied together; revision form cannot be combined with them.
• Known defect UX-17: hunk movement and folding are ineffective for this output format. File navigation and file folding work for recognized regular-file sections.

Read the workflow → · Recording · UX-04 · UX-16 · UX-17

jj diff (rendered view)

Find text and recognized file sections in a rendered diff.

In jk

[ / ] files; { / } hunks; f file list; h / l file folds; - / + hunk folds; / n N search

Result

Text search and scrolling work. Color-words regular-file sections support file navigation and file folding. Normal Git and color-words output do not produce recognized hunk sections, so hunk movement and folding are ineffective.

• Known defect UX-17: Git-format headers are not parsed into file sections, so file-list navigation and file folding are unavailable in that format.
• Known defect UX-17: color-words file sections lack @@ headers, while Git @@ headers lack recognized file sections; native hunk movement and folding do not work on ordinary output.

Read the workflow → · Recording · UX-16 · UX-17

jj show REV

Read a change description and patch together.

In jk

Enter on a log or bookmark row

jk show REV

Result

Shows the selected revision; marks do not replace the selected row.

Read the workflow → · Recording · UX-16

jj show REV...

Read several explicit revisions in one view.

In jk

jk show REV REV...

Result

Passes revisions in argument order to jj.

• The startup form requires at least one revision.

Read the workflow → · Recording · UX-16

jj status

Find changed files and current working-copy metadata.

In jk

s

jk status

Result

Displays jj status for the active repository.

Affects

working-copy snapshot

Read the workflow → · Recording · UX-16

jj status FILESET...

Check a subset of working-copy paths.

In jk

jk status FILESET...

Result

Passes each fileset directly to jj.

Affects

working-copy snapshot

Read the workflow → · Recording · UX-16

jj evolog -r REV

Understand earlier versions of the selected change.

In jk

v on a log row

Result

Shows the evolution log for the selected revision.

• No native evolog display or patch options.

Read the workflow → · Recording · UX-16

jj new PARENT

Begin work on a new change above the selected revision.

In jk

a n on a log row

Result

Creates a new working-copy change and selects it.

Affects

new change, working-copy files

Read the workflow → · Recording

jj new PARENT...

Start a change with multiple parents.

In jk

Space to mark parents in order, then a n

Result

Creates a new working-copy change using ordered marks instead of the cursor.

Affects

new merge change, working-copy files

Read the workflow → · Recording · UX-04

jj edit REV

Make an existing change the working copy.

In jk

a e on a log row

Result

Switches the working-copy revision and updates its files.

Affects

working-copy change, working-copy files

Read the workflow → · Recording

jj describe -m MESSAGE REV

Explain the selected change.

In jk

a m; Ctrl-j inserts a newline; Enter saves

Options

-m MESSAGE

Result

Rewrites the selected revision description using the inline editor.

Affects

selected revision, descendants

• Foreground editor handoff and author/reset-author options have no native form.

Read the workflow → · Recording · UX-06

jj abandon REV

Remove an empty revision without a confirmation.

In jk

a a on a log row

Result

Abandons the selected revision and lets jj rebase descendants.

Affects

selected revision, descendants, possibly working-copy files

• One revision at a time in the native form.

Read the workflow → · Recording

jj abandon REV

Inspect the content being abandoned before removing it.

In jk

a a on a log row

Result

Abandons the selected revision and lets jj rebase descendants.

Affects

selected revision, descendants, possibly working-copy files

• One revision at a time in the native form.

Read the workflow → · Recording · UX-05 · UX-06

jj abandon REV

Require review when the emptiness probe fails.

In jk

a a on a log row

Result

Abandons the selected revision and lets jj rebase descendants.

Affects

selected revision, descendants, possibly working-copy files

• One revision at a time in the native form.

Read the workflow → · Recording · UX-05 · UX-06

jj rebase -r SOURCE -o DESTINATION

Change the parent of one change.

In jk

R; source r; placement o; choose destination; Enter preview; Enter run

Options

-r -o

Result

Only SOURCE is selected for movement. Its former children are reconnected to its old parents. The roots of the moved set become children of DESTINATION. Existing destination children outside the moved set are not inserted behind it. jj preserves each revision’s changes while rewriting commits; content conflicts can remain after success.

Affects

selected source scope, rewritten source commits, source descendants

• At most one marked source is accepted; otherwise use the cursor.
• Only one destination is accepted.
• Destination search filters loaded visible rows.

Read the workflow → · Recording · UX-04 · UX-06 · UX-07

jj rebase -r SOURCE -A DESTINATION

Make one change come after an existing destination in the graph.

In jk

R; source r; placement A; choose destination; Enter preview; Enter run

Options

-r -A

Result

Only SOURCE is selected for movement. Its former children are reconnected to its old parents. The roots of the moved set become children of DESTINATION. Existing destination descendants are rebased onto the moved set, placing the moved work between DESTINATION and that later work. jj preserves each revision’s changes while rewriting commits; content conflicts can remain after success.

Affects

selected source scope, rewritten source commits, source descendants, destination descendants, possibly other workspaces’ working-copy revisions

• At most one marked source is accepted; otherwise use the cursor.
• Only one destination is accepted.
• Destination search filters loaded visible rows.

Read the workflow → · Recording · UX-04 · UX-06 · UX-07

jj rebase -r SOURCE -B DESTINATION

Make one change come before an existing destination in the graph.

In jk

R; source r; placement B; choose destination; Enter preview; Enter run

Options

-r -B

Result

Only SOURCE is selected for movement. Its former children are reconnected to its old parents. The roots of the moved set take DESTINATION’s previous parents. DESTINATION and its descendants are then rebased onto the moved set, placing the moved work immediately before the destination. jj preserves each revision’s changes while rewriting commits; content conflicts can remain after success.

Affects

selected source scope, rewritten source commits, source descendants, destination revision, destination descendants, possibly other workspaces’ working-copy revisions

• At most one marked source is accepted; otherwise use the cursor.
• Only one destination is accepted.
• Destination search filters loaded visible rows.

Read the workflow → · Recording · UX-04 · UX-06 · UX-07

jj rebase -s SOURCE -o DESTINATION

Change the parent of a change and its descendants.

In jk

R; source s; placement o; choose destination; Enter preview; Enter run

Options

-s -o

Result

SOURCE and all its descendants move together; the moved descendants retain their relationships within that set. The roots of the moved set become children of DESTINATION. Existing destination children outside the moved set are not inserted behind it. jj preserves each revision’s changes while rewriting commits; content conflicts can remain after success.

Affects

selected source scope, rewritten source commits, source descendants

• At most one marked source is accepted; otherwise use the cursor.
• Only one destination is accepted.
• Destination search filters loaded visible rows.

Read the workflow → · Recording · UX-04 · UX-06 · UX-07

jj rebase -s SOURCE -A DESTINATION

Make a change and its descendants come after an existing destination in the graph.

In jk

R; source s; placement A; choose destination; Enter preview; Enter run

Options

-s -A

Result

SOURCE and all its descendants move together; the moved descendants retain their relationships within that set. The roots of the moved set become children of DESTINATION. Existing destination descendants are rebased onto the moved set, placing the moved work between DESTINATION and that later work. jj preserves each revision’s changes while rewriting commits; content conflicts can remain after success.

Affects

selected source scope, rewritten source commits, source descendants, destination descendants, possibly other workspaces’ working-copy revisions

• At most one marked source is accepted; otherwise use the cursor.
• Only one destination is accepted.
• Destination search filters loaded visible rows.

Read the workflow → · Recording · UX-04 · UX-06 · UX-07

jj rebase -s SOURCE -B DESTINATION

Make a change and its descendants come before an existing destination in the graph.

In jk

R; source s; placement B; choose destination; Enter preview; Enter run

Options

-s -B

Result

SOURCE and all its descendants move together; the moved descendants retain their relationships within that set. The roots of the moved set take DESTINATION’s previous parents. DESTINATION becomes a child of the tips of the moved set, and its descendants keep their relationships to the rewritten destination. For a linear SOURCE-to-CHILD stack, the resulting order is the old destination parent, SOURCE, CHILD, then DESTINATION. jj preserves each revision’s changes while rewriting commits; content conflicts can remain after success.

Affects

selected source scope, rewritten source commits, source descendants, destination revision, destination descendants, possibly other workspaces’ working-copy revisions

• At most one marked source is accepted; otherwise use the cursor.
• Only one destination is accepted.
• Destination search filters loaded visible rows.

Read the workflow → · Recording · UX-04 · UX-06 · UX-07

jj rebase -b SOURCE -o DESTINATION

Change the parent of a branch.

In jk

R; source b; placement o; choose destination; Enter preview; Enter run

Options

-b -o

Result

The moved set includes SOURCE, its ancestors that are not ancestors of DESTINATION, and every descendant of those revisions. The roots of the moved set become children of DESTINATION. Existing destination children outside the moved set are not inserted behind it. jj preserves each revision’s changes while rewriting commits; content conflicts can remain after success.

Affects

selected source scope, rewritten source commits, source descendants

• At most one marked source is accepted; otherwise use the cursor.
• Only one destination is accepted.
• Destination search filters loaded visible rows.

Read the workflow → · Recording · UX-04 · UX-06 · UX-07

jj rebase -b SOURCE -A DESTINATION

Make a branch come after an existing destination in the graph.

In jk

R; source b; placement A; choose destination; Enter preview; Enter run

Options

-b -A

Result

The moved set includes SOURCE, its ancestors that are not ancestors of DESTINATION, and every descendant of those revisions. The roots of the moved set become children of DESTINATION. Existing destination descendants are rebased onto the moved set, placing the moved work between DESTINATION and that later work. jj preserves each revision’s changes while rewriting commits; content conflicts can remain after success.

Affects

selected source scope, rewritten source commits, source descendants, destination descendants, possibly other workspaces’ working-copy revisions

• At most one marked source is accepted; otherwise use the cursor.
• Only one destination is accepted.
• Destination search filters loaded visible rows.

Read the workflow → · Recording · UX-04 · UX-06 · UX-07

jj rebase -b SOURCE -B DESTINATION

Make a branch come before an existing destination in the graph.

In jk

R; source b; placement B; choose destination; Enter preview; Enter run

Options

-b -B

Result

The moved set includes SOURCE, its ancestors that are not ancestors of DESTINATION, and every descendant of those revisions. The roots of the moved set take DESTINATION’s previous parents. DESTINATION becomes a child of the tips of the moved set, and its descendants keep their relationships to the rewritten destination. For a linear SOURCE-to-CHILD stack, the resulting order is the old destination parent, SOURCE, CHILD, then DESTINATION. jj preserves each revision’s changes while rewriting commits; content conflicts can remain after success.

Affects

selected source scope, rewritten source commits, source descendants, destination revision, destination descendants, possibly other workspaces’ working-copy revisions

• At most one marked source is accepted; otherwise use the cursor.
• Only one destination is accepted.
• Destination search filters loaded visible rows.

Read the workflow → · Recording · UX-04 · UX-06 · UX-07

jj squash --from SOURCE --into DESTINATION --use-destination-message

Move all content from the marked source changes into the cursor destination.

In jk

Mark a source with Space; move to a distinct destination; a s

Options

--from (repeatable) --into --use-destination-message

Result

Keeps the destination description; jj may abandon emptied sources.

Affects

source revisions, destination revision, descendants

• Whole changes only; marks are required.
• The destination cannot also be a source.

Read the workflow → · Recording · UX-03 · UX-04 · UX-06

jj squash --from SOURCE --from SOURCE... --into DESTINATION --use-destination-message

Move all content from the marked source changes into the cursor destination.

In jk

Mark sources with Space; move to a distinct destination; a s

Options

--from (repeatable) --into --use-destination-message

Result

Keeps the destination description; jj may abandon emptied sources.

Affects

source revisions, destination revision, descendants

• Whole changes only; marks are required.
• The destination cannot also be a source.

Read the workflow → · Recording · UX-03 · UX-04 · UX-06

jj restore --from SOURCE --into @

Replace the working-copy tree with all paths from the selected source.

In jk

Clear marks; select source; a r

Options

--from --into @

Result

Uses an exact source commit and the latest working-copy destination.

Affects

working-copy tree

• All paths only.
• Any revision marks are rejected.
• Historical operation execution is unavailable for restore.

Read the workflow → · Recording · UX-03 · UX-06 · UX-04

jj bookmark list --all-remotes

Inspect named revisions and their local and remote state.

In jk

B

Result

Shows exact names and targets.

• Native list uses its own structured template.

Read the workflow → · Recording · UX-11

jj bookmark create --revision REV -- NAME

Inspect named revisions and create a bookmark.

In jk

B, then c

Result

Refreshes bookmarks and retains the command result in history.

Affects

local bookmark reference

• Remote or conflicted rows cannot use local mutation actions.
• These mutations are rejected in : command mode.
• The revision field defaults to @, not the previous log selection.

Read the workflow → · Recording · UX-11 · UX-14

jj bookmark move --to REV -- exact:NAME

Inspect named revisions and move a bookmark.

In jk

B, select local bookmark, m

Result

Refreshes bookmarks and retains the command result in history.

Affects

local bookmark reference

• Remote or conflicted rows cannot use local mutation actions.
• These mutations are rejected in : command mode.
• The revision field defaults to @; --allow-backwards has no native control.

Read the workflow → · Recording · UX-11 · UX-14

jj bookmark delete -- exact:NAME

Inspect named revisions and delete a local bookmark.

In jk

B, select local bookmark, x

Result

Refreshes bookmarks and retains the command result in history.

Affects

local bookmark reference

• Remote or conflicted rows cannot use local mutation actions.
• These mutations are rejected in : command mode.

Read the workflow → · Recording · UX-11 · UX-14

jj git remote list

Bind a network command to an explicit remote.

In jk

F or P when a remote must be chosen

Result

Lists configured remotes before the command preview.

• No native add/remove/rename/set-url form.

Read the workflow → · Recording

jj git fetch --remote exact:REMOTE

Bring remote commits and references into the local repository.

In jk

B then F

Options

--remote

Result

Runs fetch after confirmation, then refreshes bookmark state.

Affects

local commit store, remote bookmark references, tracking references

• Rejected in : command mode.

Read the workflow → · Recording · UX-11

jj git push --remote REMOTE --bookmark exact:NAME --dry-run

See what jj would publish for one bookmark and remote.

In jk

B, select bookmark, P

Options

--dry-run --bookmark --remote

Result

Contacts the remote if needed but publishes no changes.

Affects

remote connection

• This never performs a real push.
• Rejected in : command mode, including --dry-run.

Read the workflow → · Recording · UX-02 · UX-11

jj workspace list

Inspect the selected workspace without changing the app origin repository.

In jk

W or jk workspaces

Result

Shows registered workspace names, paths and working-copy state. W opens this list from another view; jk workspaces starts here.

Read the workflow → · Recording

jj -R ROOT status

Inspect the selected workspace without changing the app origin repository.

In jk

W, select workspace, Enter or s

Result

Shows workspace-specific output; Backspace returns to the workspace list.

Read the workflow → · Recording · UX-12 · UX-16

jj -R ROOT log

Inspect the selected workspace without changing the app origin repository.

In jk

W, select workspace, l

Result

Shows workspace-specific output; Backspace returns to the workspace list.

Read the workflow → · Recording · UX-12 · UX-16

jj -R ROOT diff

Inspect the selected workspace without changing the app origin repository.

In jk

W, select workspace, d

Result

Shows workspace-specific output; Backspace returns to the workspace list.

Read the workflow → · Recording · UX-12 · UX-16

jj workspace add PATH --name BASENAME

Create another directory attached to the same jj repository.

In jk

W, a a

Options

PATH; name is derived from destination basename

Result

Creates a directory and registration.

Affects

workspace metadata, workspace files

• Add accepts a path and derives the workspace name from its basename; independent name, revision, message and sparse-pattern options require command mode.

Read the workflow → · Recording · UX-10

jj -R ROOT workspace rename NAME

Change a workspace name without moving its directory.

In jk

W, select workspace, a r

Result

Updates the selected workspace name.

Affects

workspace metadata

Read the workflow → · Recording · UX-10

jj workspace forget NAME

Remove workspace registration without deleting its files.

In jk

W, select workspace, a f

Result

Removes registration; the directory remains.

Affects

workspace metadata

Read the workflow → · Recording · UX-10

jj -R ROOT workspace update-stale

Bring a workspace working copy up to date after shared history changed.

In jk

W, select workspace, u or a u

Result

Updates the selected workspace files and stale metadata.

Affects

workspace metadata, workspace files

Read the workflow → · Recording · UX-10

jj op log

Understand repository-wide changes independently of commit history.

In jk

o

Result

Renders jj operation output for the selected operation.

• Operation display flags and from/to comparisons require command mode.

Read the workflow → · Recording · UX-08

jj op show OPERATION

Understand repository-wide changes independently of commit history.

In jk

o, select operation, Enter

Result

Renders jj operation output for the selected operation.

• Operation display flags and from/to comparisons require command mode.

Read the workflow → · Recording · UX-08 · UX-16

jj op diff --operation OPERATION

Understand repository-wide changes independently of commit history.

In jk

o, select operation, d

Result

Renders jj operation output for the selected operation.

• Operation display flags and from/to comparisons require command mode.

Read the workflow → · Recording · UX-08 · UX-16

jj undo

Recover the repository state before the latest operation.

In jk

a u

Result

Runs jj undo and refreshes the log.

Affects

repository operation state, possibly working-copy files

Read the workflow → · Recording

jj redo

Recover the operation most recently undone.

In jk

a U

Result

Runs jj redo and refreshes the log.

Affects

repository operation state, possibly working-copy files

Read the workflow → · Recording

jk session command history

Connect a command, its output and resulting repository operation.

In jk

C; Enter details; o operation; y copy

Result

Shows commands and diagnostics for the current jk session; an exact operation link opens when available.

• Session history is not a persistent audit log.

Read the workflow → · Recording · UX-08 · UX-15 · UX-16

jj --ignore-working-copy COMMAND

Control execution of the pending command without changing future defaults.

In jk

o in rebase/squash/restore preview → Working copy

Options

Working copy

Result

a applies the draft to the preview; a fresh Enter confirmation executes it.

Affects

pending command options

• Only rebase, squash and restore previews expose Run options.

Read the workflow → · Recording · UX-06

jj --at-operation OPERATION COMMAND

Control execution of the pending command without changing future defaults.

In jk

o in a rebase or squash preview → Operation

Options

Operation

Result

a applies the draft to the preview; a fresh Enter confirmation executes it.

Affects

pending command options

• Only rebase, squash and restore previews expose Run options.
• Restore does not allow a historical operation.
• Operation IDs require at least 12 hexadecimal characters.
• Historical operation loading implies ignoring working-copy files; the serializer omits a redundant --ignore-working-copy flag.

Read the workflow → · Recording · UX-06

jj --ignore-immutable COMMAND

Control execution of the pending command without changing future defaults.

In jk

o in rebase/squash/restore preview → Immutable commits

Options

Immutable commits

Result

a applies the draft to the preview; a fresh Enter confirmation executes it.

Affects

pending command options

• Only rebase, squash and restore previews expose Run options.

Read the workflow → · Recording · UX-06

jj ARGS...

Use a noninteractive jj form without leaving the app.

In jk

: then arguments; Enter run

Result

Captures stdout, stderr and exit status with stdin closed; e reopens the command for correction.

• No shell expansion or foreground editor/tool handoff.
• Bookmark create/move/delete and Git fetch/push are rejected.
• Aliases and advanced forms depend on the installed jj version.
• Use Backspace to leave captured output. Escape quits jk from that view.

Read the workflow → · Recording · UX-01 · UX-09 · UX-12 · UX-13 · UX-15 · UX-16

EXECUTABLE ARGS...

Inspect output from a noninteractive program.

In jk

! then executable and arguments

Result

Runs an argv vector in the origin repository directory, capturing output with stdin closed.

• No implicit shell expansion; sh -c must be explicit for shell syntax.
• No foreground terminal handoff.
• Use Backspace to leave captured output. Escape quits jk from that view.

Read the workflow → · Recording · UX-01 · UX-09 · UX-12 · UX-13 · UX-15 · UX-16

jj log (background refresh)

Replace a slow graph refresh with a new request while keeping the prior graph usable.

In jk

r; r again while refreshing

Result

Cancels the older load; only the newest applicable result can replace the visible graph.

• This cancellation does not cover synchronous mutation or command-mode execution.

Read the workflow → · Recording

jj commit -m MESSAGE

Use a noninteractive jj form that has no dedicated jk control.

In jk

:commit -m MESSAGE

Result

Describes/commits the working-copy change and starts a new working-copy child according to jj commit behavior; the selected log row is not the operand.

Affects

working-copy revision, affected content paths, possibly ancestors or descendants

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording · UX-01 · UX-03

jj duplicate REV

Use a noninteractive jj form that has no dedicated jk control.

In jk

:duplicate REV

Result

Creates new copies of the explicit revisions; originals remain. Inspect the new change identities.

Affects

new revisions, possibly working-copy files

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording

jj revert -r REV -o DESTINATION

Use a noninteractive jj form that has no dedicated jk control.

In jk

:revert -r REV -o DESTINATION

Result

Creates changes applying the inverse of the selected revisions onto the explicit destination; original changes remain.

Affects

new revisions, possibly working-copy files

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording

jj absorb

Use a noninteractive jj form that has no dedicated jk control.

In jk

:absorb

Result

Moves eligible working-copy edits into their ancestor changes; inspect every rewritten ancestor and any remaining working-copy content.

Affects

working-copy revision, affected content paths, possibly ancestors or descendants

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording

jj interdiff --from FROM --to TO

Use a noninteractive jj form that has no dedicated jk control.

In jk

:interdiff --from FROM --to TO

Result

Shows captured command output; return to log and refresh to inspect repository changes.

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording

jj log -r REVSET

Use a noninteractive jj form that has no dedicated jk control.

In jk

:log -r REVSET

Result

Shows captured command output; return to log and refresh to inspect repository changes.

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording

jj split FILESET... -m MESSAGE

Use a noninteractive jj form that has no dedicated jk control.

In jk

:split FILESET... -m MESSAGE

Result

Splits selected files into one revision and remaining changes into another. The message names the selected part; no native fileset picker is involved.

Affects

working-copy revision, affected content paths, possibly ancestors or descendants

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording · UX-01 · UX-03

jj restore --from SOURCE FILESET...

Use a noninteractive jj form that has no dedicated jk control.

In jk

:restore --from SOURCE FILESET...

Result

Copies only matching source paths into the working-copy destination; other paths remain as they were.

Affects

working-copy revision, affected content paths, possibly ancestors or descendants

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording · UX-03

jj restore --changes-in REV FILESET...

Use a noninteractive jj form that has no dedicated jk control.

In jk

:restore --changes-in REV FILESET...

Result

Undoes the selected revision’s changes in matching paths relative to its merged parents; other paths remain unchanged.

Affects

working-copy revision, affected content paths, possibly ancestors or descendants

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · UX-03

jj squash --from SOURCE --into DESTINATION FILESET... --use-destination-message

Use a noninteractive jj form that has no dedicated jk control.

In jk

:squash --from SOURCE --into DESTINATION FILESET... --use-destination-message

Result

Moves matching paths from source to destination while retaining the destination description.

Affects

selected source paths, destination revision, descendants

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · UX-03

jj abandon REV...

Use a noninteractive jj form that has no dedicated jk control.

In jk

:abandon REV...

Result

Abandons all explicit revisions and rebases descendants with no native confirmation dialog.

Affects

explicit source revisions, descendants, possibly working-copy files

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow →

jj new -m MESSAGE PARENT...

Use a noninteractive jj form that has no dedicated jk control.

In jk

:new -m MESSAGE PARENT...

Result

Creates a new working-copy change above the explicit parents with the supplied message.

Affects

new revisions, possibly working-copy files

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow →

jj rebase -r SOURCE -r SOURCE -o DESTINATION

Use a noninteractive jj form that has no dedicated jk control.

In jk

:rebase -r SOURCE -r SOURCE -o DESTINATION

Result

Rebases every explicit source revision to the destination; inspect both moved revisions and reconnected descendants.

Affects

explicit source revisions, descendants, possibly working-copy files

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · UX-04

jj bookmark track exact:NAME --remote exact:REMOTE

Use a noninteractive jj form that has no dedicated jk control.

In jk

:bookmark track exact:NAME --remote exact:REMOTE

Result

Shows captured command output; return to log and refresh to inspect repository changes.

Affects

local bookmark or tracking metadata

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording

jj bookmark untrack exact:NAME --remote exact:REMOTE

Use a noninteractive jj form that has no dedicated jk control.

In jk

:bookmark untrack exact:NAME --remote exact:REMOTE

Result

Shows captured command output; return to log and refresh to inspect repository changes.

Affects

local bookmark or tracking metadata

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording

jj bookmark rename OLD NEW

Use a noninteractive jj form that has no dedicated jk control.

In jk

:bookmark rename OLD NEW

Result

Shows captured command output; return to log and refresh to inspect repository changes.

Affects

local bookmark or tracking metadata

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording

jj bookmark forget NAME

Use a noninteractive jj form that has no dedicated jk control.

In jk

:bookmark forget NAME

Result

Shows captured command output; return to log and refresh to inspect repository changes.

Affects

local bookmark or tracking metadata

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow → · Recording

jj workspace add PATH --name NAME -r REV

Use a noninteractive jj form that has no dedicated jk control.

In jk

:workspace add PATH --name NAME -r REV

Result

Creates a workspace at an unused destination with the supplied name and parent revision.

Affects

new workspace directory, workspace metadata

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow →

jj op restore OPERATION

Use a noninteractive jj form that has no dedicated jk control.

In jk

:op restore OPERATION

Result

Creates a new operation restoring the earlier repository view. Inspect current files and references before continuing.

Affects

repository operation history, repository view, possibly working-copy files

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow →

jj op integrate OPERATION

Use a noninteractive jj form that has no dedicated jk control.

In jk

:op integrate OPERATION

Result

Makes the identified operation part of the operation log; divergent histories can require integration.

Affects

repository operation history, repository view, possibly working-copy files

• Command mode forwards arguments to installed jj; this row is not a native form.
• Provide all operands and messages needed to avoid an interactive tool.

Read the workflow →

jj describe REV

Use a workflow that is outside the current native surface.

In jk

Leave jk and run the appropriate jj command

Result

The terminal is not handed to an editor.

• The terminal is not handed to an editor.

Read the workflow → · UX-01

jj split -i

Use a workflow that is outside the current native surface.

In jk

Leave jk and run the appropriate jj command

Result

Interactive diff tools require leaving jk.

• Interactive diff tools require leaving jk.

Read the workflow → · UX-01 · UX-03

jj diffedit

Use a workflow that is outside the current native surface.

In jk

Leave jk and run the appropriate jj command

Result

Interactive diff tools require leaving jk.

• Interactive diff tools require leaving jk.

Read the workflow → · UX-01 · UX-03

jj resolve

Use a workflow that is outside the current native surface.

In jk

Leave jk and run the appropriate jj command

Result

Interactive merge tools require leaving jk.

• Interactive merge tools require leaving jk.

Read the workflow → · UX-01

jj git push

Use a workflow that is outside the current native surface.

In jk

Leave jk and run the appropriate jj command

Result

Native push is dry-run only; : rejects git push.

• Native push is dry-run only; : rejects git push.

Read the workflow → · UX-02

jj squash/restore/commit/split -i

Use a workflow that is outside the current native surface.

In jk

Leave jk and run the appropriate jj command

Result

No native shared fileset or hunk mutation selection exists.

• No native shared fileset or hunk mutation selection exists.

Read the workflow → · UX-03

jj --at-operation OPERATION restore --from SOURCE --into DESTINATION

Use a workflow that is outside the current native surface.

In jk

:--at-operation OPERATION restore --from SOURCE --into DESTINATION

Result

Captured command mode accepts explicit historical restore operands. Native Run options refuses historical restore into symbolic @.

• Run options rejects historical restore to preserve the meaning of @.

Read the workflow → · UX-06

jj --no-integrate-operation COMMAND

Use a workflow that is outside the current native surface.

In jk

:--no-integrate-operation COMMAND

Result

Command mode forwards the option and captures its operation ID; no dedicated native recovery flow is provided.

Affects

repository operation history, repository view, possibly working-copy files

• No native detached-operation result/recovery workflow exists.

Read the workflow →