otot 0.1.2

Fuzzy URL opener for the terminal
Documentation
otot-0.1.2 has been yanked.

otot

A command-line tool for quickly opening URLs with fuzzy matching and frecency-based search.

CI

Overview

otot ("Open Tab Over There") helps you quickly open links from your terminal by remembering each usage and allowing fuzzy pattern matching. Instead of typing full URLs, use partial matches to quickly access your most frequently and recently visited sites.

Installation

cargo install otot

Or build from source:

git clone https://github.com/idiomattic/otot
cd otot
cargo install --path .

Usage

Open a full URL

otot open github.com/rust-lang/rust

The tool automatically opens the URL in your default browser.

Fuzzy matching

otot open github/rust

This finds the most relevant URL containing both "github" and "rust" based on your visit history. The ranking uses a frecency algorithm that considers both frequency (how often you visit) and recency (when you last visited).

Tip:

Aliasing the open subcommand is helpful for ergonomic, quick usage:

alias o="otot open"

Configuration

Set your preferred browser:

otot config set -k preferred_browser -n firefox

View current settings:

otot config get -k preferred_browser

Show config file location:

otot config path

How It Works

otot maintains a local SQLite database tracking your URL visits. When you use fuzzy matching, it:

  1. Breaks your input into segments
  2. Searches for URLs in your history that match on:
    • exact match of base domain (e.g. "github")
    • exact match on last path segment (e.g. "rust")
    • intermediate segments may be skipped, but when provided, must match in the correct relative order (not all must be provided)
  3. Ranks results by frecency score (visit count × recency multiplier)
  4. Opens the best match

Configuration

Default config location: ~/.config/otot/default-config.toml

Available settings

  • preferred_browser: Browser command (e.g., "firefox", "chrome", "brave")

Database

The database is a simple SQLite file that tracks:

  • URLs you've opened
  • Visit counts
  • Last access timestamps
  • URL segments for fuzzy matching

Location:

Platform Value Example
Linux $XDG_DATA_HOME or $HOME/.local/share /home/alice/.local/share
macOS $HOME/Library/Application Support /Users/Alice/Library/Application Support
Windows {FOLDERID_LocalAppData} C:\Users\Alice\AppData\Local

Privacy

The database stores visit counts and timestamps but no personal browsing data beyond the URLs you explicitly open with otot.

Inspiration

This project is heavily inspired by zoxide, a wonderful CLI for navigating between directories.

License

MIT