Tatuin is a task aggregation tool that allows you to manage and track your tasks from various providers in one convenient place. Currently, the project supports the next providers:

• Obsidian
• Todoist
• GitLab TODO
• GitHub Issues

Tatuin provides users with an easy-to-use Text User Interface (TUI) for viewing and managing their tasks.

• Cross-provider Task Management: Tatuin allows you to create(Todoist and Obsidian), view and manage tasks across different task management platforms.
• Command-line Interface (CLI): The project is designed using a text-based interface, making it accessible from the command line.
• Task Filters & Status Changes: Easily filter and update your tasks' statuses as needed.
• Save and load UI state: The user can save the current view's state (selected provider, selected project, used filters) and switch between states.
• Theming support: The user can choose between themes or create their own.

1. Install via cargo

   cargo install tatuin
   ~/.cargo/bin/tatuin --help

2. Install via homebrew

   brew install panter-dsd/tap/tatuin

To add a new provider, use the following command:

tatuin add-provider

This command will guide you through setting up the integration for the specified provider.

Currently, only the Todoist and Obsidian providers support task creation. The Todoist provider is out of the box, but for Obsidian, you must use the obsidian-local-rest-api plugin. The information about the installation and configuration process can be found within Obsidian's UI. Tatuin works seamlessly with both secure and insecure configurations, but note that you must install a certificate for the secure setup (refer to the wiki for details).

Tatuin now includes theming support, allowing you to customize the application's appearance to suit your preferences. To use a new theme, download a theme file (for instance, nord.theme) and save it into the configuration directory: ~/.config/tatuin. For example, you might place a theme file as ~/.config/tatuin/nord.theme.

You can activate a theme at launch by using the --theme command-line option followed by the theme name: tatuin --theme nord

Alternatively, to set a default theme, edit the configuration file located at ~/.config/tatuin/settings.toml and specify the theme name as follows:

theme = "nord"

This feature enables seamless switching between themes, offering both flexibility and a personalized experience.

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

You can find announcements about new functionality on the Telegram channel. I'd be glad to receive any feedback from you.

Distributed under the MIT License. See LICENSE.txt for more information.

Tatuin is a growing project with plans to add many more providers in future releases. Stay tuned and join us on this journey of improving task management!

For any questions or feedback, please feel free to open an issue on GitHub!