Settings
Settings
Current can read preferences from a config.current file. Defaults are built in, so you only add the keys you want to change.
Search order
~/.config/current/config.current~/.config/current/config~/Library/Application Support/com.raj.current/config.current~/Library/Application Support/com.raj.current/config
Storage
Storage
| Key | Default | Accepted values | Purpose |
|---|---|---|---|
library-rootlibrary-root = ~/Documents/current | Unset, resolves to ~/Documents/current | Absolute path, ~/ path, or empty value | Moves the Current library root while keeping daily stream files transparent on disk. |
config-fileconfig-file = ?machine.current | None | Relative path, absolute path, ~/ path, or ?optional path | Includes another config file after the current file is parsed. Later included values can override earlier ones. |
Editor
Editor
| Key | Default | Accepted values | Purpose |
|---|---|---|---|
font-familyfont-family = "JetBrains Mono" | Unset, uses the macOS monospaced system font | Installed font family name, quoted or unquoted | Overrides the editor font family while preserving Current's plain-text editor behavior. |
font-sizefont-size = 13 | 13 | Number from 6 through 72 | Controls the AppKit Markdown editor text size. |
line-heightline-height = 22 | 22 | Number from 8 through 120 | Controls the editor line box height for calmer daily writing. |
content-widthcontent-width = 700 | 700 | Number from 320 through 2000 | Sets the centered writing column width used by the timeline. |
Timeline
Timeline
| Key | Default | Accepted values | Purpose |
|---|---|---|---|
recent-daysrecent-days = 7 | 7 | Integer from 1 through 3650 | Controls how many recent days Current loads around today on launch. |
history-batch-dayshistory-batch-days = 14 | 14 | Integer from 1 through 3650 | Controls how many older days are added as the timeline reaches the load trigger. |
history-window-dayshistory-window-days = 180 | 180 | Integer from 1 through 10000 | Controls the retained in-memory timeline window before older rows become spacer height. |
hide-empty-weekendshide-empty-weekends = false | false | true, false, yes, no, on, off, 1, or 0 | Skips empty Saturday and Sunday placeholders while keeping existing weekend notes visible. |
Saving
Saving
| Key | Default | Accepted values | Purpose |
|---|---|---|---|
autosave-delayautosave-delay = 0.55 | 0.55 | Number from 0 through 60 | Sets the debounce delay before a dirty day document is written to disk. |
Markdown
Markdown
| Key | Default | Accepted values | Purpose |
|---|---|---|---|
markdown-marker-visibilitymarkdown-marker-visibility = muted | muted | muted | Keeps Markdown punctuation visible but visually quiet in the editor. |
config.current
Complete starter file
Empty values reset to Current defaults. Whole-line comments and blank lines are ignored. Included files are parsed after the containing file, so machine-specific overrides can stay separate.
# Current configuration
# Syntax is key = value. Blank lines and whole-line # comments are ignored.
# Empty values reset a setting to Current's default.
library-root = ~/Documents/current
font-family =
font-size = 13
line-height = 22
content-width = 700
recent-days = 7
history-batch-days = 14
history-window-days = 180
autosave-delay = 0.55
hide-empty-weekends = false
markdown-marker-visibility = muted
# Split config into another file:
config-file = extras.current
config-file = ?machine.current