Vicinae Extension#
Cairn includes a Vicinae extension that lets you save, search, and browse bookmarks directly from the Vicinae launcher — without leaving your current context.
Features#
- Search — find bookmarks from the Vicinae command palette
- Browse — list all bookmarks in a panel
- Save — add the current browser tab as a bookmark (with optional tags)
Installation#
Via Installer (Recommended)#
If Vicinae is installed, run:
sh install.sh --with-extensionOr on a fresh install:
curl -sSL https://raw.githubusercontent.com/ndy40/cairn/main/install.sh | sh -s -- -y --with-extensionManual#
The extension source is in vicinae-extension/ in the repository. Build with:
cd vicinae-extension
npm install
npm run buildThen register the extension with the vici toolchain.
Requirements#
- Vicinae installed and running
cairnbinary inPATH
The extension delegates all operations to the cairn CLI — no separate daemon or server is needed.
Usage#
Open the Vicinae launcher and use the cairn prefix to interact:
| Action | Example |
|---|---|
| Search bookmarks | Type cairn golang |
| Browse all bookmarks | Open the Cairn panel |
| Save current page | Use the “Save to Cairn” action |
Commands Invoked#
The extension calls these CLI commands internally:
| Extension action | CLI command |
|---|---|
| Search | cairn search <query> --json |
| List | cairn list --json |
| Save | cairn add <url> --tags <tags> |
| Delete | cairn delete <id> |
| Pin | cairn pin <id> |