Automic VaultAutomic Vault

brew

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 commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install topydo

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install topydo

MacPorts ports tree · office/topydo/Portfile · source: api.github.com

Linux

Debian aptverified · 92%
sudo apt install topydo

Debian stable package indexes · topydo · source: deb.debian.org

Nixverified · 92%
nix profile install nixpkgs#topydo

nixpkgs package indexes · pkgs/by-name/to/topydo/package.nix · source: api.github.com

overview

Package summary

Todo list application using the todo.txt format

Commands and aliases

  • topydo

history

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.

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

  • narrow executable package without higher-risk signals

Signals

  • metadata:no-higher-risk-signals

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Installs with 1 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
topydocliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version0.16
manager updated
local dataok
upstreamnot checked
latest detectednot detected

https://github.com/topydo/topydo

  • infoNo package-manager update timestamp was available.low confidence
  • infoNo cached GitHub release or tag data was available.https://github.com/topydo/topydonone confidence

install metadata

Package metadata

Package keybrew:topydo
Version0.16
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/topydo
Homepagehttps://github.com/topydo/topydo
Repositoryhttps://github.com/topydo/topydo
Upstream docshttps://topydo.github.io/topydo
LicenseGPL-3.0-or-later
Source archivehttps://files.pythonhosted.org/packages/11/6a/8278ac5a59ec633322dcdff278bf74ce8c9d513370cf41d1ecfa5e0376d0/topydo-0.16.tar.gz
Dependenciespython@3.14
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Nametopydo
Version Scheme0
Revision0
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

topydo 0.15+dfsg1-1

advanced todo.txt terminal utility for managing tasks

https://github.com/topydo/topydo

sudo apt install topydo
  • Section: text
  • Architecture: all
  • 2 dependencies
  • 1 provides
  • 5 optional deps
  • normalized package name match
  • Matched by: Topydo
Debian stable package indexes · deb.debian.org · Debian stable package indexes: topydo from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

topydo

nix profile install nixpkgs#topydo
  • normalized package name match
  • Matched by: Topydo
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/to/topydo/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

topydo 0.14-5.2

advanced todo.txt terminal utility for managing tasks

https://github.com/topydo/topydo

sudo apt install topydo
  • Section: universe/text
  • Architecture: all
  • 2 dependencies
  • 1 provides
  • 5 optional deps
  • normalized package name match
  • Matched by: Topydo
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: topydo from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
MacPorts95%

topydo

sudo port install topydo
  • normalized package name match
  • Matched by: Topydo
MacPorts ports tree · api.github.com · MacPorts ports tree: office/topydo/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

Same workflow

  • pterShares av.db curated category or tags: cli, productivity, task-management, todo-txt.
  • todo-txtShares av.db curated category or tags: cli, productivity, task-management, todo-txt.
  • tasklineShares av.db curated category or tags: cli, productivity, task-management.
  • todoist-cliShares av.db curated category or tags: cli, productivity, task-management.
  • todoist-cli-goShares av.db curated category or tags: cli, productivity, task-management.
  • todomanShares av.db curated category or tags: cli, productivity, task-management.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment