Tiny Talking Todos

Manage TinyTalkingTodos lists and items via the ttt CLI

Security Scan

The skill is internally consistent: it documents using a ttt CLI to manage TinyTalkingTodos, requires the ttt binary (no extra credentials), and contains no surprising install or data-exfiltration instructions.

Purpose & Capability

Name/description match the runtime instructions. The only required binary is `ttt`, which is exactly what the SKILL.md instructs the agent to run. Examples and commands align with a todo-CLI purpose.

Instruction Scope

SKILL.md confines actions to running `ttt` CLI commands (list/create/update/delete/undo/daemon). It does not instruct reading unrelated system files or contacting endpoints beyond the service the CLI integrates with. Commands that touch auth and daemon behavior are expected for a CLI client.

Install Mechanism

The skill is instruction-only (no automatic install), but SKILL.md recommends installing `@ojschwa/ttt-cli` from npm. That is a plausible, proportional install route for a CLI; users should verify the npm package and publisher before installing. Absence of an automated install spec means no code will be written by the skill itself.

Credentials

The skill declares no required env vars. SKILL.md mentions `ttt auth export` which exports CLI credentials as environment variables for scripts—this is reasonable for automation, but users should be aware those tokens may appear in the environment and take care not to expose them. The skill does not request unrelated credentials.

Persistence & Privilege

No `always: true`. default invocation settings allow autonomous invocation (platform default) but the skill does not request persistent system-level privileges or modify other skills/configs. Its daemon behavior pertains to the CLI's own process, not the agent.

Assessment

This skill appears coherent and only needs the `ttt` CLI. Before installing or using it: 1) verify the npm package and publisher (@ojschwa) and the TinyTalkingTodos site; 2) confirm you trust the `ttt` binary on your PATH (it will make network calls to your account); 3) be careful with `ttt auth export` because it places tokens in the environment—don't export tokens into shells or CI where they can leak; and 4) if you want stronger assurance, inspect the npm package source or prefer installing from a vetted release. If you have sensitive data in todos, consider the privacy implications of giving a CLI network access to that data.

TinyTalkingTodos CLI

Use ttt to manage todo lists and items from the command line. The CLI syncs with TinyTalkingTodos in real-time.

Installation

npm install -g @ojschwa/ttt-cli

Or install locally for development:

cd /path/to/talking-todo/ttt-cli
npm install
npm run build
npm link

Verify with ttt --help.

Authentication

Before using the CLI, the user must be authenticated:

# Check auth status
ttt auth status

# Login via browser (opens OAuth flow)
ttt auth login

# Logout
ttt auth logout

# Export credentials as env vars (for scripts)
ttt auth export

List Management

List all lists

ttt list ls

Output (compact, token-efficient):

Today [2/5]
Groceries [0/3]
Work Tasks [1/4]

For structured data:

ttt list ls --json

Get list details

ttt list get "Groceries"
# or by ID
ttt list get list-abc123

Create a new list

ttt list create "Weekend Plans"
ttt list create "Shopping" --icon "🛒" --color "#FF6B6B"

Options:

• --color <hex> - Background color
• --icon <emoji> - List icon
• --type <type> - List type

Update a list

ttt list update "Groceries" --name "Shopping List"
ttt list update "Shopping List" --icon "🛒" --color "#00FF00"

Options:

• --name <name> - New list name
• --color <hex> - Background color
• --icon <emoji> - List icon
• --type <type> - List type

Delete a list

ttt list delete "Old List"
ttt list rm "Old List"  # alias

# Force delete even if list has todos
ttt list delete "Old List" --force

Todo Operations

List todos in a list

ttt todo ls --list "Groceries"

Output (compact):

Groceries [1/4]
✓ Milk id:todo-abc123
○ Bread id:todo-def456
○ Eggs id:todo-ghi789
○ Butter id:todo-jkl012

For JSON output:

ttt todo ls --list "Groceries" --json

Add a todo

Basic:

ttt todo add "Buy avocados" --list "Groceries"

With options:

ttt todo add "Doctor appointment" --list "Health" \
  --date 2026-02-15 \
  --time 14:30 \
  --notes "Bring insurance card"

ttt todo add "Try new pasta place" --list "Restaurants" \
  --url "https://example.com/restaurant" \
  --street-address "123 Main St" \
  --rating 4

ttt todo add "Tomatoes" --list "Groceries" \
  --amount 2.50 \
  --category "Produce" \
  --emoji "🍅"

All --list options:

Option	Description	Example
--notes <text>	Additional notes	--notes "organic preferred"
--date <YYYY-MM-DD>	Due date	--date 2026-02-15
--time <HH:MM>	Due time	--time 14:30
--url <url>	Associated URL	--url "https://..."
--emoji <emoji>	Item emoji	--emoji "🎉"
--email <email>	Associated email	--email "contact@..."
--street-address <addr>	Location	--street-address "123 Main"
--number <n>	Numeric value	--number 5
--amount <n>	Amount/price	--amount 12.99
--rating <1-5>	Star rating	--rating 4
--type <A-E>	Item type	--type A
--category <name>	Category	--category "Urgent"

Mark a todo as done

ttt todo done todo-abc123

The todo ID is shown in the compact output format after id:.

Mark a todo as not done

ttt todo undone todo-abc123

Update a todo

ttt todo update todo-abc123 --text "New text"
ttt todo update todo-abc123 --category "Urgent" --date 2026-02-15
ttt todo update todo-abc123 --done   # mark as done
ttt todo update todo-abc123 --not-done  # mark as not done

Options:

• --text <text> - New todo text
• --notes, --date, --time, --url, --emoji, --email, --street-address
• --number, --amount, --rating, --type, --category
• --done / --not-done - Toggle completion status

Delete a todo

ttt todo delete todo-abc123
# or use alias
ttt todo rm todo-abc123

Batch add todos

Add multiple todos at once using JSON:

ttt todo batch-add --list "Groceries" --items '[
  {"text": "Milk"},
  {"text": "Eggs", "fields": {"category": "Dairy"}},
  {"text": "Bread", "fields": {"amount": 3.50}}
]'

Each item requires text and optionally fields with any todo field.

Batch update todos

Update multiple todos at once:

ttt todo batch-update --items '[
  {"id": "todo-abc123", "fields": {"done": true}},
  {"id": "todo-def456", "fields": {"text": "Updated text", "category": "Urgent"}}
]'

Each item requires id and fields with the updates to apply.

Undo Operations

All mutating operations are recorded and can be undone:

# Undo the last operation
ttt undo

# Undo the last 3 operations
ttt undo 3

# View undo history
ttt history
ttt history --limit 20
ttt history --json

Undo supports: todo add/delete/update, batch-add/update, mark done/undone, list create/update/delete.

Daemon (Performance)

The daemon keeps a persistent WebSocket connection for faster commands:

# Start daemon (auto-starts on first command if not running)
ttt daemon start

# Check status
ttt daemon status

# Stop daemon
ttt daemon stop

The daemon auto-shuts down after 30 minutes of inactivity.

Best Practices

1. Use compact output (default) when displaying lists to users - it's token-efficient
2. Use --json when you need to parse data or extract specific fields
3. Reference lists by name for readability, or by ID for precision
4. Check auth status before operations if you're unsure of login state
5. Extract todo IDs from compact output (format: id:<todo-id>) for updates
6. Use batch operations when adding or updating multiple items - more efficient than individual calls
7. Use undo if you make a mistake - ttt undo reverts the last operation

Example Workflows

Add items to grocery list

ttt todo add "Milk" --list "Groceries" --category "Dairy"
ttt todo add "Bread" --list "Groceries" --category "Bakery"
ttt todo add "Apples" --list "Groceries" --amount 3.50 --category "Produce"

Check and complete tasks

# View todos
ttt todo ls --list "Today"

# Mark one done (using ID from output)
ttt todo done todo-xyz789

Create a new list with todos

ttt list create "Weekend Trip" --icon "🏕️"
ttt todo add "Pack tent" --list "Weekend Trip"
ttt todo add "Check weather" --list "Weekend Trip" --url "https://weather.com"
ttt todo add "Gas up car" --list "Weekend Trip"

Batch add items efficiently

ttt todo batch-add --list "Party Supplies" --items '[
  {"text": "Balloons", "fields": {"category": "Decorations"}},
  {"text": "Cake", "fields": {"category": "Food", "amount": 45.00}},
  {"text": "Plates", "fields": {"category": "Supplies", "number": 20}},
  {"text": "Candles", "fields": {"category": "Decorations"}}
]'

Mark multiple items done

ttt todo batch-update --items '[
  {"id": "todo-abc", "fields": {"done": true}},
  {"id": "todo-def", "fields": {"done": true}},
  {"id": "todo-ghi", "fields": {"done": true}}
]'

Undo a mistake

# Accidentally deleted something? Undo it
ttt undo

# Made several mistakes? Undo multiple
ttt undo 3