https://github.com/rollecode/tasks-cli

A simple, dependency-free bash script to list your Todoist tasks sorted by creation date (oldest first) with colorized output and clickable task links.
https://github.com/rollecode/tasks-cli

Last synced: 27 days ago
JSON representation

A simple, dependency-free bash script to list your Todoist tasks sorted by creation date (oldest first) with colorized output and clickable task links.

• Host: GitHub
• URL: https://github.com/rollecode/tasks-cli
• Owner: rollecode
• Created: 2025-08-03T17:30:22.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2025-10-17T13:56:21.000Z (8 months ago)
• Last Synced: 2026-05-02T13:33:33.772Z (28 days ago)
• Language: Shell
• Size: 17.6 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

          
# 🤖 Tasks CLI

[![version](https://img.shields.io/badge/version-1.2.0-blue.svg?style=for-the-badge)](#)

![OpenAI](https://img.shields.io/badge/OpenAI-74aa9c?style=for-the-badge&logo=openai&logoColor=white)

![bash](https://img.shields.io/badge/bash-%23121011.svg?style=for-the-badge&color=%23222222&logo=gnu-bash&logoColor=white)

![Todoist](https://img.shields.io/badge/todoist-badge?style=for-the-badge&logo=todoist&logoColor=%23ffffff&color=%23E44332)

![Linear](https://img.shields.io/badge/Linear-5E6AD2?style=for-the-badge&logo=linear&logoColor=white)

![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54)

## Unified task management 🦾

Bash script that lists tasks from Todoist and Linear with AI-powered translation and Obsidian-ready formatting.

## Features

- **Multi-platform** - Fetch tasks from Todoist, Linear, or both

- **Obsidian-ready output** (default) - Markdown bullet format for easy pasting

- **AI translation** - Translate foreign language tasks to English via OpenAI

- **Present tense formatting** - Convert tasks to changelog-style format

- **Smart cleanup** - Strip URLs and markdown formatting

- **Chronological sorting** - Tasks sorted by creation date (newest first)

- **Completed tasks** - Option to show completed Linear tasks

- **Summary statistics** - Shows task count and date range

- **Zero dependencies** - Only requires `curl`, `python3`, and standard bash

## Usage

```bash

# Default - show tasks from both Todoist and Linear

tasks

# Show only Todoist tasks

tasks --todoist

# Show only Linear tasks

tasks --linear

# Include completed tasks (Linear only)

tasks --completed

# Include dates

tasks --dates

# Include task URLs

tasks --task-urls

# Combine options

tasks --linear --completed --dates

# Show help

tasks --help

```

## Example Output

**Default (Obsidian mode):**

```

* Schedule team meeting

* Review pull request

* Update documentation

--- 3 tasks for 5 days timespan

```

**With dates:**

```

* 2024-10-14: Schedule team meeting

* 2024-10-13: Review pull request

--- 2 tasks for 2 days timespan

```

## Requirements

- `bash` (any modern version)

- `curl` (for API requests)

- `python3` (for JSON parsing, OpenAI API calls)

- At least one of: Todoist API token or Linear API key

- OpenAI API key