otty / apps

All apps/Watson

Watson

watson

A wonderful CLI to track your time!

Runs as watson|macOS, Linux, Windows|jazzband.github.io

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

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

token

Lifted into your secret store; the rest of the file syncs.

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

apps/watson/otty.tomlThe file this page is generated from

id = "watson"

name = "Watson"

homepage = "https://jazzband.github.io/Watson/"

description = "A wonderful CLI to track your time!"

executables = ["watson"]

[dotfiles]

# https://jazzband.github.io/Watson/user-guide/configuration/ — "Watson

# configuration and data are stored inside your user's application folder.

# Depending on your system, the default path is likely:

# MacOSX: ~/Library/Application Support/watson/config

# Windows: %appdata%\watson\config

# Linux: ~/.config/watson/config"

# — one location under three names, which is `[appData]`. It is

# watson/watson.py's

# self._dir = kwargs.pop('config_dir', None) or click.get_app_dir('watson')

# self.config_file = os.path.join(self._dir, 'config')

# The same directory holds frames, state and last_sync — the tracked time

# itself and the sync bookkeeping, not configuration — so only `config` is

# listed.

paths = ["[appData]/watson/config"]

exclude = []

# Not a whole-file secret: the file is a Python INI of options

# (confirm_new_project, date_format, week_start, the backend URL). Only the

# token is lifted out.

secret = []

# Read at the start of a `watson` invocation and rewritten before it exits.

side_effect = false

# watson/watson.py, push()/pull():

# dest = config.get('backend', 'url')

# token = config.get('backend', 'token')

# … 'Authorization': "Token {}".format(token)

# and the CLI documents `watson config backend.token 7e329263e329`. Written

# under [backend] as a plain `token = …` line, so the prefix is `token`. The

# base directory is one path on every platform, so the rule cannot miss a

# spelling and let the token sync in the clear.

[[dotfiles.secret_paths]]

file = "[appData]/watson/config"

match = { prefix = ["token"] }

[commands]

format = 1

label = "Watson time tracker"

description = "Start tracking, check status and read the log. Editing, merging and sync commands are left out."

quality = "ai-draft"

base = "fig:watson"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/watson.ts"

license = "MIT"

[[commands.subcommand]]

path = ["start"]

label = "Start tracking"

description = "Start monitoring time for a project."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/watson.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "args"

label = "Project and tags"

description = "Project name followed by +tag entries."

type = "string"

position = 0

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "at"

label = "Start time"

description = "Start frame at this time, (YYYY-MM-DDT)?HH:MM(:SS)?."

type = "string"

option = ["--at"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "gap"

label = "Leave gap after previous frame"

type = "boolean"

option = ["--gap", "-g"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "no_gap"

label = "No gap after previous frame"

type = "boolean"

option = ["--no-gap", "-G"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "confirm_new_project"

label = "Confirm new project"

type = "boolean"

option = ["--confirm-new-project", "-c"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "confirm_new_tag"

label = "Confirm new tag"

type = "boolean"

option = ["--confirm-new-tag", "-b"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "start"

label = "Start project"

fields = ["args", "at"]

required = ["args"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["args", "at"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["gap", "no_gap", "confirm_new_project", "confirm_new_tag"]

[[commands.subcommand]]

path = ["status"]

label = "Current status"

description = "Show what is being tracked now."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/watson.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "project"

label = "Only project"

type = "boolean"

option = ["--project", "-p"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "tags"

label = "Only tags"

type = "boolean"

option = ["--tags", "-t"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "elapsed"

label = "Only elapsed time"

type = "boolean"

option = ["--elapsed", "-e"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "status"

label = "Show status"

fields = ["project", "tags", "elapsed"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["project", "tags", "elapsed"]

[[commands.subcommand]]

path = ["log"]

label = "Show log"

description = "Display recorded frames for a timespan."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/watson.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "day"

label = "Current day"

type = "boolean"

option = ["--day", "-d"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "week"

label = "Current week"

type = "boolean"

option = ["--week", "-w"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "month"

label = "Current month"

type = "boolean"

option = ["--month", "-m"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "year"

label = "Current year"

type = "boolean"

option = ["--year", "-y"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "all"

label = "All activity"

type = "boolean"

option = ["--all", "-a"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "from"

label = "From date"

type = "string"

option = ["--from", "-f"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "to"

label = "To date"

type = "string"

option = ["--to", "-t"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "project"

label = "Project filter"

type = "string"

option = ["--project", "-p"]

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "tag"

label = "Tag filter"

type = "string"

option = ["--tag", "-T"]

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "current"

label = "Include running frame"

type = "boolean"

option = ["--current", "-c"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "reverse"

label = "Reverse day order"

type = "boolean"

option = ["--reverse", "-r"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "json"

label = "JSON output"

type = "boolean"

option = ["--json", "-j"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "csv"

label = "CSV output"

type = "boolean"

option = ["--csv", "-s"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "week"

label = "This week"

fields = ["week", "project"]

set = { week = [true] }

[[commands.subcommand.task]]

id = "day"

label = "Today"

fields = ["day"]

set = { day = [true] }

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["day", "week", "month", "project"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["from", "to", "current", "reverse", "json", "csv", "tag", "year", "all"]

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/watson. 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.