# Install topydo with Homebrew, apt, MacPorts, Nix Todo list application using the todo.txt format. Version 0.16 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:topydo ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install topydo ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install topydo ``` Evidence: MacPorts ports tree: office/topydo/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Debian apt (92%): ```sh sudo apt install topydo ``` Evidence: Debian stable package indexes: topydo from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#topydo ``` Evidence: nixpkgs package indexes: pkgs/by-name/to/topydo/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:topydo - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.16 - **Source summary:** Todo list application using the todo.txt format - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-or-later - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - topydo (cli) - topydo (alias) ## Dependencies - python@3.14 ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.16 - Local data: ok - Upstream repository: https://github.com/topydo/topydo - info: No package-manager update timestamp was available. - info: No cached GitHub release or tag data was available. ## Project history and usage topydo is a console-oriented todo.txt application. Its README describes it as a powerful todo list application using the todo.txt format, with command-line, prompt, and column/TUI interfaces. ### Project history The project sits in the todo.txt ecosystem rather than inventing its own database format. The README says its CLI was originally inspired by Gina Trapani's todo.txt CLI, while topydo adds native support for extensions such as due dates, start dates, dependencies, recurring items, sorting, grouping, aliases, and stable text-based identifiers. The official documentation is published as a TiddlyWiki-style site, matching the project's hacker-friendly niche: a single-file text-task workflow with command references, configuration tiddlers, output format notes, and UI documentation. ### Adoption history The input package facts show topydo packaged across Homebrew, Debian, MacPorts, Nix, and Ubuntu, which is broad for a console todo.txt tool. That distribution pattern reflects adoption by users who want a portable plain-text task file but prefer a richer Python CLI/TUI than the original shell-oriented todo.txt tools. ### How it is used Typical use is to install with pip3, then run topydo in one of three interfaces: direct CLI commands, topydo prompt for a command loop, or topydo columns for a vim-like text UI with customizable columns. The README emphasizes that the todo.txt file remains compliant and can still be processed by other todo.txt tools. Package nerds tend to care about topydo because it keeps the durable artifact as plain text while offering scriptable outputs such as iCalendar, JSON, and Graphviz Dot. That makes it useful for terminal-first personal workflows, backups, sync, and small automations without adopting a hosted task service. ### Why package nerds care topydo is a representative package-manager-friendly productivity CLI: Python-based, plain-text-first, and interoperable with the wider todo.txt format. Its significance is strongest for users who value editable files, Unix-style tool chaining, and terminal UI ergonomics. ### Timeline - Project docs: Official README presents topydo as a todo.txt-compatible application with CLI, prompt, and column modes. - Package adoption: Input package facts list Homebrew, Debian, MacPorts, Nix, and Ubuntu packages. - Current docs: Official documentation is published at topydo.github.io/topydo as a TiddlyWiki containing command, configuration, output, and UI topics. ### Related projects - The README links the todo.txt format and Gina Trapani's todo.txt CLI as direct context, and also references bram85/todo.txt-tools. ### Sources - - - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** topydo - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Debian apt - topydo - 0.15+dfsg1-1: normalized package name match | Debian stable package indexes: topydo from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | advanced todo.txt terminal utility for managing tasks | https://github.com/topydo/topydo - Nix - topydo: normalized package name match | nixpkgs package indexes: pkgs/by-name/to/topydo/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - topydo - 0.14-5.2: normalized package name match | Ubuntu 24.04 LTS package indexes: topydo from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | advanced todo.txt terminal utility for managing tasks | https://github.com/topydo/topydo - MacPorts - topydo: normalized package name match | MacPorts ports tree: office/topydo/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [pter](https://www.automicvault.com/pkg/brew/pter/) - Shares av.db curated category or tags: cli, productivity, task-management, todo-txt. - [todo-txt](https://www.automicvault.com/pkg/brew/todo-txt/) - Shares av.db curated category or tags: cli, productivity, task-management, todo-txt. - [taskline](https://www.automicvault.com/pkg/brew/taskline/) - Shares av.db curated category or tags: cli, productivity, task-management. - [todoist-cli](https://www.automicvault.com/pkg/brew/todoist-cli/) - Shares av.db curated category or tags: cli, productivity, task-management. - [todoist-cli-go](https://www.automicvault.com/pkg/brew/todoist-cli-go/) - Shares av.db curated category or tags: cli, productivity, task-management. - [todoman](https://www.automicvault.com/pkg/brew/todoman/) - Shares av.db curated category or tags: cli, productivity, task-management. - [ttdl](https://www.automicvault.com/pkg/brew/ttdl/) - Shares av.db curated category or tags: cli, productivity, task-management. - [ultralist](https://www.automicvault.com/pkg/brew/ultralist/) - Shares av.db curated category or tags: cli, productivity, task-management. - [vit](https://www.automicvault.com/pkg/brew/vit/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, management, productivity, python, python-3-14. - [dstask](https://www.automicvault.com/pkg/brew/dstask/) - Local package facts share a topical domain. Shared terms: cli, management, productivity, task, task-management. ## Combined YAML source View the package source record on GitHub. [combined/topydo.yml](https://github.com/automic-vault/db/blob/main/combined/topydo.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph