Manage Your Code Repositories Using Jujutsu

Things on this page are fragmentary and immature notes/thoughts of the author. Please read with your own judgement! To install Jujutsu (jj) using Homebrew, run:

Installation Using Homebrew (Linux / macOS)¶

brew install jj

Jujutsu Configuration¶

Identity Configuration¶

After installation, you should configure your identity:

jj config set --user user.name "Your Name"
jj config set --user user.email "your.email@example.com"

Interaction with Git Configurations¶

1. Jujutsu respects .gitignore files and also core.excludesFile (if defined) from .gitignore.

2. Settings in .gitinore (other than core.excludesFile) are not read by Jujutsu at this time.

3. In a Git-backed repo, jj reads remote names and URLs directly from the .git/config so that commands like jj git fetch and jj git push work seamlessly.

4. In “colocated” mode, jj and Git share the same underlying commit objects and branch references.

Jujutsu Configuration Leves¶

Jujutsu resolves configuration in the following order (higher number overrides lower):

1. Built-in: Default settings.

2. User: ~/.config/jj/config.toml (global for you).

3. Repo-managed: .config/jj/config.toml (committed to the project).

4. Repo-local: .jj/repo/config.toml (private to your local clone and should never be committed).

5. Workspace-local: .jj/workspaces/<name>/config.toml (if using multiple workspaces).

6. Command-line: arguments passed via --config-toml.

Manage Jujutsu Configurations¶

1. View current config.

jj config list

2. Edit user config.

jj config edit --user 

3. Find config file path.

jj config path --user

Use Jujutsu with a Git Repository¶

jj git init --colocate