Install & setup

VisualJJ works out of the box. You don't need to install JJ separately.

Install from VS Code Marketplace

  1. Open VS Code (or Cursor)
  2. Go to Extensions (Cmd+Shift+X / Ctrl+Shift+X)
  3. Search for "visualjj"
  4. Click Install

For manual installation or specific versions, download the VSIX from visualjj.com/beta.

Open VisualJJ

  1. Open a folder containing a Git repository
  2. Click the VisualJJ icon in the Activity Bar
  3. You'll see your change tree

On first run, VisualJJ may ask you to confirm name and email to set as author of changes.

Requirements

  • VS Code 1.80+ (or Cursor, or other VS Code-based editors)
  • A Git repository
  • Network access for pushing and creating PRs

Supported environments

  • VS Code on macOS, Windows, Linux
  • Cursor and other VS Code-based editors
  • WSL, SSH remotes, Dev Containers

GitHub authentication

VisualJJ uses your Git credentials for pushing. For creating and merging PRs, VS Code prompts you to sign in to GitHub.

If PRs aren't working, see Troubleshooting.