Skip to content

Latest commit

 

History

27 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

thinx

Thinx is a Things 3-compatible todo app for the Terminal, running on Linux, macOS, and Windows.

thinx example screenshot

Getting Started

go install github.com/pkwagner/thinx/cmd/thinx@latest

Alternatively, binaries for Linux, macOS, and Windows are available on the releases page. Just double-click under Windows, or install on Linux or macOS with:

install -Dm755 <path_to_downloaded_binary> ~/.local/bin/thinx

Run with thinx from your Terminal afterwards. Make sure that your PATH includes either ~/go/bin/ (first method) or ~/.local/bin/ (second method).

Features

  • Create, view, and edit todos
  • Auto-sync with Things Cloud
  • Vim-ish keybindings -- no worries, arrow keys work too!

Roadmap

  • Integrations
    • Local provider
    • Self-hosted provider
  • Core features
    • Edit support for projects and checklists (inside todos)
    • Evening schedule support
    • Todo reordering
    • Search & filter todos
    • Trash view / restore deleted todos
  • App features
    • Remappable keybindings
    • CLI for integrating into Waybar etc.
    • Logout / database reset (workaround: delete config)
  • Chore
    • Test behavior with multiple open windows
    • Add support for package managers:
      • Homebrew
      • AUR
      • NixOS

Related Projects

To the best of my knowledge, thinx is the first Things Cloud-compatible TUI. However, there are many other cool projects out there, some of which are:

Name Description
things-cloud-sdk SDK and CLI for Things Cloud, which also powers thinx. Fork of nicolai86/things-cloud-sdk. No TUI.
things3-cloud Another SDK and CLI variant for Things Cloud written in Rust. No TUI.
things-cloud-mcp MCP server, also using things-cloud-sdk. No TUI.
things-tui TUI for Things 3 written in Python. No Things Cloud support, it instead uses the local Things database and therefore only runs on macOS.
things-cli Another CLI for Things 3 written in Go. No Things Cloud support either, local database and therefore macOS only.

Releases

Contributors

Languages