Skip to main content

Description

The timo clear command removes all thoughts from your list in one operation. This is useful when you want to start fresh or archive all your current thoughts. To prevent accidental data loss, this command requires explicit confirmation.

Syntax

timo clear --confirmed

Options

--confirmed
boolean
required
Required confirmation flag to prevent accidental deletion of all thoughts. You must explicitly include this flag for the command to execute.

Examples

Clear all thoughts

timo clear --confirmed
The command executes silently on success.

Attempting to clear without confirmation

timo clear
error: the following required arguments were not provided:
  --confirmed

Usage: timo clear --confirmed

For more information, try '--help'.

Common Use Cases

# Clear all thoughts to start a new week
timo clear --confirmed
This command permanently deletes ALL thoughts from your list. This action cannot be undone. Make sure you have backed up any important thoughts before running this command.
The --confirmed flag is required by design. If you try to run timo clear without it, the command will fail. This is a safety feature to prevent accidental data loss.
If you only want to remove specific thoughts, use the timo remove command instead with the appropriate thought IDs.
Consider using timo list before clearing to review what you’re about to delete.

Build docs developers (and LLMs) love