Aliases
LazyJJ provides aliases that add value beyond built-in JJ commands. For shortcuts, see lazyjj-shortcuts.toml.
Philosophy: Value-Add Over Shortcuts
LazyJJ’s approach to aliases:
- Value-add aliases: Do something Git or vanilla JJ don’t (these are in the main reference)
- Pure shortcuts: Just shorter names for existing commands (separate file)
This keeps the main aliases file focused on LazyJJ’s unique contributions to the JJ workflow.
Value-Add Aliases
These aliases add flags or combine commands beyond what JJ provides natively:
Diff Aliases
| Command | Shortcut | JJ Command | Purpose |
|---|---|---|---|
diff-summary | diffs | diff --summary --no-pager | Compact diff summary |
diff-files | diffls | diff --name-only --no-pager | List changed files only |
Log Aliases
| Command | JJ Command | Purpose |
|---|---|---|
log-short | log --limit 10 | Quick log (last 10 commits) |
Shortcuts
LazyJJ also provides shortcuts via lazyjj-shortcuts.toml:
| Shortcut | Command |
|---|---|
diffs | diff-summary |
diffls | diff-files |
gf | git fetch |
For stack-related shortcuts (stack, top, sync, etc.), see Stack Workflow.
For GitHub shortcuts (prv, pro, sprs, etc.), see GitHub Integration.
Examples
# Using value-add aliasesjj diff-files # Just file namesjj diff-summary # Summary of changesjj log-short # See recent history (last 10)
# Using shortcutsjj diffs # Same as diff-summaryjj diffls # Same as diff-filesjj gf # Same as 'jj git fetch'Customizing Aliases
To add your own aliases or override LazyJJ’s, create a file in ~/.config/jj/conf.d/ that sorts after lazyjj-*:
[aliases]# Add custom aliasesmylog = ["log", "--limit", "5", "-T", "builtin_log_compact"]
# Override a LazyJJ aliaslog-short = ["log", "--limit", "20"]
Ernesto Jiménez