@ojschwa/ttt-cli

Tiny Talking Todos CLI

Manage your todo lists from the terminal. Built for developers, power users, and AI agents who prefer the command line.

šŸ¦€ Works great with OpenClaw — let your personal AI assistant manage your todos for you.

npm install -g @ojschwa/ttt-cli

Quick Start

Get up and running in under a minute.

1

Install the CLI

npm install -g @ojschwa/ttt-cli
2

Login to your account

ttt auth login
3

Start managing your todos

ttt list ls                          # List all lists
ttt todo add "Buy groceries" --list "Today"  # Add a todo
ttt todo done <todo-id>              # Mark as done

Commands

Everything you need to manage your lists and todos.

Lists

Create, view, update, and delete your todo lists.

ttt list lsttt list create "Shopping"ttt list update "Shopping" --color bluettt list delete "Old List"

Todos

Add todos, mark them done, and keep things organized.

ttt todo ls --list "Today"ttt todo add "Task" --list "Today"ttt todo done <id>ttt todo undone <id>

Rich Fields

Add notes, dates, categories, and more to any todo.

--notes "Details here"--date 2026-02-14 --time 15:00--category "Work"--rating 5 --amount 9.99

Batch Operations

Add or update multiple todos at once with JSON input.

ttt todo batch-add --list ...ttt todo batch-update --items ...

Undo

Made a mistake? Undo any operation, anytime.

ttt undottt undo 3ttt history

Daemon

Keep a persistent connection for faster commands.

ttt daemon startttt daemon statusttt daemon stop

Token-Efficient Output

Compact output by default, perfect for LLM agents. Switch to JSON when you need structured data.

Default Output

Today [1/6]
āœ“ Morning walk       id:abc123
ā—‹ Buy groceries      id:def456
ā—‹ Call dentist        id:ghi789

JSON Output

ttt todo ls --list "Today" --json

[
  {
    "id": "abc123",
    "text": "Morning walk",
    "done": true
  },
  ...
]

AI Agent Integration

The CLI includes an OpenClaw skill that lets AI agents manage your todo lists automatically.

Setup in 3 steps

1

Install and authenticate

npm install -g @ojschwa/ttt-cli && ttt auth login
2

Install the skill

clawhub install ttt
3

Restart your gateway

Your agent can now manage your todo lists.

šŸ¦€

Works great with OpenClaw — the open-source personal AI assistant that runs on your machine. Let your lobster manage your todos for you.

Requirements

  • Node.js 18+
  • A Tiny Talking Todos account

Ready to try the CLI?

Install the CLI and start managing your todos from the terminal.

Still got questions?

Would love to hear from you in our Discord community.Or reach out via our support form