tinycity

Run tinycity commands on behalf of the user to search, list, import, and export bookmarks.

Installation check

Before running any tinycity command, check whether it is installed:

tinycity --version

If the command is not found, install it based on the platform:

macOS/Linux (Homebrew):

brew tap yetanotherchris/tinycity https://github.com/yetanotherchris/tinycity
brew install tinycity

Windows (Scoop):

scoop bucket add tinycity https://github.com/yetanotherchris/tinycity
scoop install tinycity

Linux (wget fallback):

wget -O tinycity "https://github.com/yetanotherchris/tinycity/releases/latest/download/tinycity"
chmod +x tinycity
sudo mv tinycity /usr/local/bin/

macOS (curl fallback):

curl -o tinycity -L "https://github.com/yetanotherchris/tinycity/releases/latest/download/tinycity"
chmod +x tinycity
sudo mv tinycity /usr/local/bin/

Windows (PowerShell fallback):

Invoke-WebRequest -Uri "https://github.com/yetanotherchris/tinycity/releases/latest/download/tinycity.exe" -OutFile "tinycity.exe"

After installing, run tinycity config to set up bookmark sources before the first use.

Commands

Search bookmarks

tinycity search "<query>"
tinycity search "<query>" --urls        # also search inside URLs
tinycity search "<query>" --launch      # open the first result in the browser
tinycity search "<query>" --export      # save results to exported-bookmarks.md

List all bookmarks

tinycity ls
tinycity ls --export

Configure sources

tinycity config                                    # show current config
tinycity config --add-source chrome
tinycity config --add-source brave
tinycity config --add-source edge
tinycity config --add-source opera
tinycity config --add-source /path/to/file.md
tinycity config --add-source /path/to/bookmarks.html
tinycity config --remove-source chrome

Export bookmarks

tinycity export --source all --directory ~/backup
tinycity export --source chrome --directory ~/backup

Import bookmarks

tinycity import --target chrome --directory ~/backup
tinycity import --target all --directory ~/backup

Behaviour

• Map the user's natural language request to the appropriate command.
• If the user says "find", "look for", or "search", use tinycity search.
• If the user says "show all" or "list", use tinycity ls.
• If the user says "open" or "launch", use tinycity search "<query>" --launch.
• If the user says "export" or "back up", use tinycity export.
• If the user says "import" or "restore", use tinycity import.
• If results are empty, tell the user and suggest checking sources with tinycity config.
• Do not guess or fabricate bookmark data — always run the command and return the real output.

Displaying results

The raw CLI output contains ANSI colour codes and OSC 8 terminal hyperlinks. Strip those and render the results in plain markdown that matches the tinycity visual style:

1. Header line — bold count and query, e.g. **4 bookmark(s) found for 'google'.**
2. Bullet list — one entry per result in the format:

   - [Title](url) (domain)
   

   where domain is the hostname extracted from the URL (e.g. drive.google.com).

Example output for tinycity search "google drive":

2 bookmark(s) found for 'google drive'.

• Google Drive (drive.google.com)
• Google Drive - Shared (drive.google.com)