Where Does Timewarrior Store Config and Data?
Where Timewarrior keeps config and interval data under XDG homes, plus the legacy folder and override paths.
Last updated
Timewarrior splits config and interval data across XDG homes on modern installs: settings and extensions under config, monthly data files under data share. Legacy versions kept everything in one dot folder that still wins when present. An environment variable overrides the data root.
Monthly files plus tags and undo state make the database human-browsable. The config command edits settings without opening files. Sync setups point the data root at shared storage while keeping config local. Extensions travel with config.
Where Timewarrior stores this, by platform
~/.config/timewarrior/timewarrior.cfg
Settings and extensions in the XDG config tree with monthly data files under data share. TIMEWARRIORDB overrides the data root for syncing. Legacy ~/.timewarrior layouts take precedence when present; migrate deliberately.
Frequently asked questions
how do I move Timewarrior data
Copy the config and data trees to the new machine at matching XDG paths. Monthly data files plus tags and undo state travel together. Legacy single-folder layouts migrate with the documented shell snippet.
how do I sync time data between machines
Set TIMEWARRIORDB in the shell environment to point the whole database elsewhere, such as a synced folder. Config file settings cannot do this; only the environment counts. Restart shells after changing it.
old vs new directory layout
Old installs use the single ~/.timewarrior folder for everything, which keeps precedence when present. New installs split XDG config and data homes. Migrate deliberately rather than mixing both layouts.
Notice an outdated path? Let us know.