otty / apps

All apps/tuxedo

tuxedo

Fast, keyboard-driven terminal UI for todo.txt.

Runs as tuxedo|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

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

share_token

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

· keybinds.toml Sync

· themes/*.toml Sync

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

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

id = "tuxedo"

name = "tuxedo"

homepage = "https://github.com/webstonehq/tuxedo"

description = "Fast, keyboard-driven terminal UI for todo.txt."

executables = ["tuxedo"]

[dotfiles]

# Tuxedo's upstream README documents config.toml and custom themes under the

# XDG config directory. Its phone-capture share_token is a bearer credential,

# so keep only that TOML key secret.

# https://github.com/webstonehq/tuxedo#configuration

paths = [

"[configHome]/tuxedo/config.toml",

"[configHome]/tuxedo/keybinds.toml",

"[configHome]/tuxedo/themes/*.toml",

]

exclude = []

secret = []

side_effect = false

[[dotfiles.secret_paths]]

file = "[configHome]/tuxedo/config.toml"

match = { key_path = ["share_token"] }

[commands]

format = 1

label = "todo.txt command line"

description = "One-shot tuxedo commands against the todo file chosen by TODO_FILE or TODO_DIR. Other subcommands (append, pri, archive and so on) are left out."

quality = "ai-draft"

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

[[commands.source]]

id = "readme"

kind = "manual"

url = "https://github.com/webstonehq/tuxedo/blob/main/README.md#command-line-interface"

revision = "2026-10-27"

evidence = """

tuxedo add "Pay rent +home @bank due:2026-07-01" # or: tuxedo a "..."

tuxedo ls @bank # filter by context

tuxedo do 3 # mark task 3 complete

| `add` | `a` | `TEXT...` | Add a task (natural-language dates supported, same as the `n` prompt). |

| `do` | `done`, `complete` | `N...` | Mark tasks complete (recurring tasks spawn their next instance). |

- `--json` — emit machine-readable JSON instead of text.

"""

[[commands.subcommand]]

path = ["add"]

label = "Add a task"

description = "Append a new task to the todo file."

[[commands.subcommand.source]]

id = "readme"

kind = "manual"

url = "https://github.com/webstonehq/tuxedo/blob/main/README.md#command-line-interface"

revision = "2026-10-27"

evidence = """

tuxedo add "Pay rent +home @bank due:2026-07-01" # or: tuxedo a "..."

| `add` | `a` | `TEXT...` | Add a task (natural-language dates supported, same as the `n` prompt). |

- `--json` — emit machine-readable JSON instead of text.

"""

[[commands.subcommand.field]]

id = "text"

label = "Task text"

description = "Can include +project, @context and due:YYYY-MM-DD."

type = "string"

position = 0

min = 1

multiple = true

sources = ["readme"]

[[commands.subcommand.field]]

id = "json"

label = "JSON output"

type = "boolean"

option = ["--json"]

sources = ["readme"]

[[commands.subcommand.task]]

id = "add"

label = "Add task"

fields = ["text"]

required = ["text"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["text", "json"]

[[commands.subcommand]]

path = ["ls"]

label = "List tasks"

description = "List tasks, optionally filtered by +project, @context or text."

[[commands.subcommand.source]]

id = "readme"

kind = "manual"

url = "https://github.com/webstonehq/tuxedo/blob/main/README.md#command-line-interface"

revision = "2026-10-27"

evidence = """

tuxedo ls @bank # filter by context

- `--json` — emit machine-readable JSON instead of text.

"""

[[commands.subcommand.field]]

id = "terms"

label = "Filter terms"

type = "string"

position = 0

multiple = true

sources = ["readme"]

[[commands.subcommand.field]]

id = "json"

label = "JSON output"

type = "boolean"

option = ["--json"]

sources = ["readme"]

[[commands.subcommand.task]]

id = "list"

label = "List tasks"

fields = ["terms", "json"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["terms", "json"]

[[commands.subcommand]]

path = ["do"]

label = "Complete tasks"

description = "Mark tasks complete by their 1-based line number."

[[commands.subcommand.source]]

id = "readme"

kind = "manual"

url = "https://github.com/webstonehq/tuxedo/blob/main/README.md#command-line-interface"

revision = "2026-10-27"

evidence = """

tuxedo do 3 # mark task 3 complete

| `do` | `done`, `complete` | `N...` | Mark tasks complete (recurring tasks spawn their next instance). |

"""

[[commands.subcommand.field]]

id = "numbers"

label = "Task numbers"

type = "integer"

position = 0

min = 1

multiple = true

sources = ["readme"]

[[commands.subcommand.task]]

id = "do"

label = "Complete tasks"

fields = ["numbers"]

required = ["numbers"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["numbers"]

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