Install Timo
Timo is a lightweight Rust CLI tool. You can install it using Homebrew or build it from source.
Prerequisites
Before installing Timo, ensure you have:
- macOS, Linux, or Windows with WSL
- Terminal access
Timo stores all data locally in a SQLite database in your home directory
Installation methods
Homebrew
Cargo
From source
The easiest way to install Timo is with Homebrew:Install with Homebrew
brew tap yourusername/timo
brew install timo
Add your first thought
timo add "My first thought"
Homebrew automatically handles updates. Run brew upgrade timo to get the latest version
If you have Rust installed, you can install Timo using Cargo:Install Rust
If you don’t have Rust installed, get it from rustup.rs:curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Install Timo
This will download, compile, and install the timo binary Build Timo from source for the latest development version:Clone the repository
git clone https://github.com/yourusername/timo.git
cd timo
Build the project
The compiled binary will be in target/release/timo Install the binary
Or manually copy the binary:cp target/release/timo /usr/local/bin/
Building from source requires Rust 1.70 or later
Data storage location
Timo stores your thoughts in a SQLite database at:
The database is created automatically the first time you run Timo. No configuration needed.
Back up your thoughts by copying the ~/.timo/timo.db file
Upgrading Timo
To upgrade to the latest version:
Uninstalling
To remove Timo from your system:
To also remove your data:
Deleting ~/.timo will permanently remove all your thoughts. Back up the database first if needed
Troubleshooting
Command not found
If you get a “command not found” error after installation:
-
Make sure Cargo’s bin directory is in your PATH:
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
-
For Zsh users, add to
~/.zshrc instead:
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Permission denied
If you encounter permission errors:
chmod +x ~/.cargo/bin/timo
What’s next?
Now that Timo is installed, head to the quickstart guide to add your first thought.