Quickstart

Install

Search for "visualjj" in the VS Code extensions marketplace and click Install. That's it — no other tools needed.

Open a repository

Open a folder that contains a Git repository. Click the VisualJJ icon in the sidebar to see your tree.

Click on different changes to see what each one contains. Main runs along the left — everything branching off it is work in progress.

Make a change

Edit a file in your project. Your edit appears as a new change in the tree automatically — no staging needed. VisualJJ gives it an automatic title based on what you changed.

To refine the title, click the pencil icon next to it or right-click → Describe.

Shape your work

Try reshaping to get comfortable:

  • Double-click any change to edit it — including earlier ones in your stack. Your work in progress stays flexible; you can always go back and fix things.
  • Squash combines a small fix into its parent change.
  • Rebase moves a change onto the latest main (drag and drop, or right-click → Rebase on Main).

See Shape for the full set of operations.

Share it

Right-click your change and select Create Request (PR). VisualJJ pushes to GitHub and opens the PR. Sign in to GitHub when prompted.

Ship it

Once approved, right-click and select Ship Request. Your change is now part of main.

You can also ship directly without a request. See Ship.

Next steps

  • Concepts — the mental model behind VisualJJ
  • Shape — split, combine, reorder
  • Share — share, review, and iterate