otty / dotfiles

All tools/Taskwarrior

Taskwarrior

taskwarrior

Taskwarrior is Free and Open Source Software that manages your TODO list from the command line.

Detected by task | macOS, Linux, Windows |taskwarrior.org

Sync it taskwarrior.toml

Sync rules

What travels, what stays, what never leaves

Synced2 paths, copied whole to your other machines

~/.taskrc

[configHome]/task/taskrcpattern

Stays on this machineInside a file that otherwise syncs

~/.taskrclines starting with data.location, hooks.location

# [Created by task 3.4.1]

# Taskwarrior program configuration file.

data.location=/Users/octocat/.taskmachine-local

hooks.location=/Users/octocat/.task/hooksmachine-local

include /opt/homebrew/share/doc/task/rc/dark-16.theme

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

[configHome]/task/taskrclines starting with

data.locationhooks.location

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

~/.taskrclines starting with include

…

data.location=/Users/octocat/.task

hooks.location=/Users/octocat/.task/hooks

include /opt/homebrew/share/doc/task/rc/dark-16.thememachine-local

# Reports

report.next.columns=id,start.age,entry.age,depends,priority,project,tags,recur,scheduled.countdown,due.relative,until.remaining,description,urgency

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

[configHome]/task/taskrclines starting with

include

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Excluded1 path, state rather than configuration — never uploaded

~/.task/directory

Not a subtraction from the paths above: this is everything else Taskwarrior writes in your home directory that is state, not configuration. It keeps a whole-home manager like chezmoi from sweeping those up, and it still holds if the synced paths are ever widened.

Taskwarrior in your home directory Every rule on this page, by file

# [Created by task 3.4.1]

# Taskwarrior program configuration file.

data.location=/Users/octocat/.taskmachine-local

hooks.location=/Users/octocat/.task/hooksmachine-local

include /opt/homebrew/share/doc/task/rc/dark-16.theme

…

Each machine keeps its own copy of these.

…

data.location=/Users/octocat/.task

hooks.location=/Users/octocat/.task/hooks

include /opt/homebrew/share/doc/task/rc/dark-16.thememachine-local

# Reports

report.next.columns=id,start.age,entry.age,depends,priority,project,tags,recur,scheduled.countdown,due.relative,until.remaining,description,urgency

…

Each machine keeps its own copy of these.

· ~/.task/ Exclude

data.locationhooks.location

Each machine keeps its own copy of these.

include

Each machine keeps its own copy of these.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/taskwarrior.tomlThe file this page is generated from

id = "taskwarrior"

name = "Taskwarrior"

homepage = "https://taskwarrior.org"

description = "Taskwarrior is Free and Open Source Software that manages your TODO list from the command line."

# `task` is also the binary of go-task, whose configuration is a Taskfile.yml

# committed to a repository and never anything under the user's home. This

# entry is Taskwarrior's, which is the one with a per-user config file.

detect = ["task"]

# taskrc(5) FILES: "$HOME/.taskrc", and "Additionally, if no ~/.taskrc exists,

# taskwarrior will check if the XDG_CONFIG_HOME environment variable is

# defined", reading $XDG_CONFIG_HOME/task/taskrc — the configuration base

# directory, written as `[configHome]` so the variable is honoured instead of

# the specification's default being hard-coded.

paths = [

"~/.taskrc",

"[configHome]/task/taskrc",

]

# ~/.task is the task database, not configuration — taskrc(5) on

# data.location: "This is a path to the directory containing all the

# Taskwarrior data."

exclude = ["~/.task/"]

# Taskwarrior holds no credential file of its own. The man page's SYNC section

# names no configuration variables at all, so there is no stored sync

# credential to lift out either.

secret = []

# All three name a filesystem location on this machine, but not for the same

# reason, so they are two rules. Both spellings of the file on each, or a rule

# stops running the moment the user switches to the XDG location.

# taskrc(5), data.location: "This is a path to the directory containing all the

# Taskwarrior data. By default, it is set up to be ~/.task", and

# hooks.location: "This is a path to the hook scripts directory. By default it

# is ~/.task/hooks" — a user who moved either wrote an absolute path to this

# disk, and that is exactly what they would want back when rebuilding it.

[[machine_lines]]

file = ["~/.taskrc", "[configHome]/task/taskrc"]

match = { prefix = ["data.location", "hooks.location"] }

scope = "backup"

# `include` pulls in a theme or a fragment by path, and the themes ship with

# the package, so where they sit differs with the package manager that

# installed Taskwarrior — a fact about the kind of machine, the same on every

# box of that OS and architecture.

[[machine_lines]]

file = ["~/.taskrc", "[configHome]/task/taskrc"]

match = { prefix = ["include"] }

scope = "platform"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/taskwarrior. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits data.location and hooks.location for you — that part is Otty’s own sync, or a template you write by hand.