Skip to main content

​
Description

The timo list command prints all thoughts stored in your list to the terminal. Each thought is displayed with its unique ID, which you can use with other commands like remove. You can filter thoughts by label and optionally display label information.

​
Syntax

timo list [options]

​
Options

​
-l, --label
string
Filter the list to show only thoughts with the specified label. This is useful when you want to focus on a specific category of thoughts.
​
-s, --show-labels
boolean
Display the label for each thought in the output. By default, labels are hidden unless you use this flag.

​
Examples

​
List all thoughts

timo list

[1]: Buy groceries
[2]: Work on quarterly report
[3]: Schedule meeting with design team
[4]: Review pull request #123
[5]: Pick up dry cleaning

​
List all thoughts with labels

timo list --show-labels

[1]: Buy groceries  #errands
[2]: Work on quarterly report  #work
[3]: Schedule meeting with design team  #work
[4]: Review pull request #123  #development
[5]: Pick up dry cleaning  #errands

​
List thoughts with a specific label

timo list -l work

[2]: Work on quarterly report
[3]: Schedule meeting with design team

​
List work thoughts with labels visible

timo list -l work -s

[2]: Work on quarterly report  #work
[3]: Schedule meeting with design team  #work

​
Common Use Cases

# Check all your thoughts for the day
timo list

# Review work-related items
timo list -l work
The ID numbers shown in the list output are used with the timo remove command to delete specific thoughts.
When filtering by label with -l, only thoughts that have been assigned that exact label will be displayed.

Build docs developers (and LLMs) love

Get started for freeTalk to us