ttx-cli 1.2.0

Tiny tasks and time tracker

ttx — Tiny Tasks + Time Tracker

Author: Martin Dahl

---

tt is a lightweight, terminal-first task & time tracking tool with both a CLI and an interactive TUI.
It’s designed for speed, simplicity, and scriptability — with sensible defaults and flexible time parsing.

---

✨ Features

• Tasks: add, list, complete, archive.
• Time logs:
  • Start/stop timers
  • Manual entries (--start/--end, --minutes, --ago)
  • Flexible parsing (09:00, :30, 1h15, today, yesterday, now)
  • Strict ISO mode (optional)
• Reports & exports:
  • Summaries by task, tag, or day
  • CSV and Markdown export
• Interactive TUI (powered by Textual):
  • Task + log views
  • Filter indicator bar
  • Entry marking, bulk actions, sorting
  • Persisted UI state
• Configurable:
  • XDG-compliant config (~/.config/ttx/config.yml)
  • Rounding rules
  • Confirmation prompts for destructive ops
• SQLite backend:
  • WAL mode enabled
  • Auto-created indexes
• Developer-friendly:
  • Semantic-release CI (auto changelog + versioning)
  • Conventional Commits
  • PyPI-ready packaging

---

📦 Installation

From GitHub (editable dev install)

git clone https://github.com/martindahlswe/ttx-clix-cli.git
cd ttx-cli
pip install -e .

Now you can run:

ttx --help

From GitHub directly (pip)

pip install "git+https://github.com/martindahlswe/ttx-clix-cli.git@main#egg=ttx-cli"

From PyPI (once published)

pip install ttx-cli

---

🚀 Usage

CLI examples

# Initialize DB
ttx init

# Add a task and list tasks
ttx task add "Finances"
ttx task ls

# Start and stop a timer
ttx start 1
ttx stop

# Add a manual log
ttx log add 1 --start "09:00" --end "10:15"
ttx log add 1 --minutes 30
ttx log add 1 --ago 1h15

# Show logs
ttx log ls --all --week

# Generate a report
ttx report --group day --since week

# Open TUI
ttx tui

TUI keybindings

• ↑ / ↓ / Tab — navigate
• Enter — open details
• M — mark entry
• D — bulk delete marked
• + / - — adjust minutes
• ? — help overlay
• T — toggle theme

---

⚙️ Configuration

Config file lives at:

• Linux/macOS: ~/.config/ttx/config.yml

Example:

rounding:
  minutes: 15
input:
  strict_iso: false
confirmations:
  bulk_delete: true

---

🛠 Development

Run tests

pytest

Commit conventions

We use Conventional Commits.
Examples:

feat(cli): add ttx examples command
fix(tui): guard _save_state when widgets are unmounted
feat!: drop pomodoro feature (breaking)

Release flow

• Merge to main with proper commit messages
• semantic-release bumps version, updates changelog, creates GitHub Release

---

📄 License

MIT © Martin Dahl

---

📌 Links

• Repo: https://github.com/martindahlswe/ttx-cli
• Issues: https://github.com/martindahlswe/ttx-cli/issues