Skip to main content

​
Capture your thoughts in the terminal

Timo is a command-line tool that helps you capture fleeting thoughts, ideas, and reminders without leaving your terminal. Instead of context-switching to a notes app, just type timo add and keep working. All your thoughts are stored locally in a SQLite database, searchable instantly, and organized with labels.

Installation

Install Timo with Homebrew or build from source

Quickstart

Add your first thought in under 2 minutes

Commands

Explore all available commands

Labels

Organize thoughts with labels

​
Why Timo?

Timo is built for developers who live in the terminal and need a frictionless way to capture thoughts:
  • Stay in flow: No context-switching to other apps
  • Lightning fast: Add, search, and list thoughts in milliseconds
  • Local and private: All data stored in SQLite on your machine
  • Simple and focused: Five commands is all you need
  • Beautiful output: Color-coded, easy-to-read terminal display

​
Key features

Add and manage thoughts

Quickly capture thoughts from the command line with timo add

Search thoughts

Find thoughts instantly with keyword search using timo search

Organize with labels

Group related thoughts with labels and filter by label

SQLite storage

Persistent, reliable storage backed by SQLite

Colored output

Clean, colored terminal output for better readability

Lightweight

Fast Rust binary with minimal dependencies

​
Example workflow

Here’s how Timo fits into your daily workflow: 
# Capture a quick thought
timo add "Check if the API supports batch requests"

# Add a thought with a label
timo add "Refactor auth module" --label "work"

# List all thoughts
timo list
# Output:
# [1]: Check if the API supports batch requests
# [2]: Refactor auth module

# Search for specific thoughts
timo search "API"
# Output:
# [1]: Check if the API supports batch requests

# Remove a thought when done
timo remove 1
Use labels to separate work thoughts, personal reminders, and learning notes

​
What’s next?

1

Install Timo

Get Timo installed on your system with installation instructions
2

Add your first thought

Follow the quickstart guide to capture your first thought
3

Explore commands

Learn about all available commands

Build docs developers (and LLMs) love

Get started for freeTalk to us