/sleek

todo.txt manager for Linux, Windows and MacOS, free and open-source (FOSS)

Primary LanguageTypeScriptMIT LicenseMIT

sleek

Code scan and test cases sleek

❤️ Become a contributer.

sleek is currently being rewritten. Now is a good time to join us in our mission to provide a user-friendly, free, and open-source todo.txt client. We're actively inviting passionate contributors skilled in React, TypeScript, Electron, and Jest/Playwright to join our collaborative effort. The develop branch reflects the most recent progress. Here you'll find our roadmap: https://github.com/users/ransome1/projects/3.

For those interested, we've updated our contribution guidelines, which you can find here: https://github.com/ransome1/sleek/blob/master/CONTRIBUTING.md.

sleek is an open-source (FOSS) todo manager based on the todo.txt syntax. It's available for Windows, MacOS and Linux

sleek is an open-source (FOSS) todo manager based on the todo.txt syntax. Stripped down to only the most necessary features, and with a clean and simple interface, sleek aims to help you focus on getting things done.

All classic todo.txt attributes are supported and enhanced by additional features. Creating todos is straightforward, and tag-based filtering in tandem with highly customisable grouping and smart full-text search allows for rapid information retrieval. Completed todos can be hidden or archived into separate done.txt files. Easy integration with other todo.txt apps is facilitated by continuously scanning todo.txt files for changes.

sleek is available for Windows, MacOS and Linux, and in several languages. For a detailed list of features, see below. Useful information can be found in sleek's wiki.

Sponsor sleek

Pushing sleek to the Apple and Microsoft app stores creates annual costs. You can help covering these by sponsoring the project.

Get sleek from Apple Mac App Store

Get sleek from Apple Mac App Store

Get sleek from Microsoft Store

English badge

Get sleek from Snap Store

Get it from the Snap Store

Install sleek from Snap Store using: sudo snap install sleek

Get sleek from Flathub

Download on Flathub

Install sleek from Flathub using: flatpak install flathub com.github.ransome1.sleek

Run it using: flatpak run com.github.ransome1.sleek

Get sleek from Homebrew

Install sleek from Homebrew. brew install --cask sleek

Get sleek from Arch User Repository

Install sleek from AUR.

  1. Setup Yay
  2. yay -S sleek

Download sleek

You can download sleek for Windows, MacOS and Linux from

Build sleek from source code

  1. Setup Git and node.js.
  2. Clone sleek git clone https://github.com/ransome1/sleek.git and cd into sleek's directory
  3. Install dependencies npm install
  4. Build and package sleek npm run package
  5. The binaries will be placed in the working directory, in a subfolder named release/build

sleek's features

  • Uses existing todo.txt files or creates new ones
  • Add and search for todos by
    • priority
    • context
    • project
    • due date
    • creation date
    • completion date
    • recurrence (repeating todo)
    • threshold dates
    • pomodoro timer
  • Filter, sort, and group todos by all available attributes
  • Invert the sorting of each group
  • Find todos using full-text search compatible with todo.txt syntax
  • Inline autocomplete available for adding contexts and projects
  • Dates and priorities can be selected by built-in picker elements
  • Navigable via keyboard shortcuts
  • Tabindex available
  • Due date notifications
  • Toggle between dark and light mode
  • Compact view and zoom available
  • Completed todos can be shown, hidden, and archived
  • Multiline todos can be created
  • Filters are sorted alphanummerically
  • Hyperlinks detected automatically
  • File watcher scans todo.txt files for changes
  • Simultaneously manage multiple todo.txt files
  • Language options
    • English
    • German
    • Italian
    • Spanish
    • French
    • Simplified Chinese
    • Brazilian Portugese
    • Japanese
    • Turkish
    • Hungarian
    • Czech
    • Polish
    • Russian

A more detailed documentation can be found in sleek's wiki.