Skip to content

Configuration

Configuration

jjj uses a TOML configuration file stored in .jjj/config.toml within the repository.

Config File Format

# Project name
name = "my-project"
# Default reviewers for all solutions
default_reviewers = ["alice", "bob"]
# Custom key-value settings
[settings]
key = "value"

Fields

FieldTypeDescription
namestringProject name
default_reviewersstring[]Reviewers added to all new solutions
settingsmapArbitrary key-value pairs for custom settings

Deprecated: review.default_required has been removed. Review is now per-solution: a solution requires review when it has assigned reviewers. Use --review on jjj solution new or jjj solution review to assign reviewers. Solutions without assigned reviewers do not require sign-offs.

VS Code Extension

The VS Code extension uses the jjj.path setting to locate the jjj binary:

{
"jjj.path": "/usr/local/bin/jjj"
}

If not set, the extension looks for jjj on PATH.

Environment Variables

VariableDescription
JJJ_DIROverride the metadata directory (default: .jjj/)
JJ_PATHPath to the jj binary

Storage Location

All metadata is stored in .jjj/ at the repository root:

.jjj/
config.toml # Project configuration
problems/ # Problem TOML files
solutions/ # Solution TOML files
critiques/ # Critique TOML files
milestones/ # Milestone TOML files