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#

If Vicinae is installed, run:

sh install.sh --with-extension

Or on a fresh install:

curl -sSL https://raw.githubusercontent.com/ndy40/cairn/main/install.sh | sh -s -- -y --with-extension

Manual#

The extension source is in vicinae-extension/ in the repository. Build with:

cd vicinae-extension
npm install
npm run build

Then register the extension with the vici toolchain.

Requirements#

  • Vicinae installed and running
  • cairn binary in PATH

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:

ActionExample
Search bookmarksType cairn golang
Browse all bookmarksOpen the Cairn panel
Save current pageUse the “Save to Cairn” action

Commands Invoked#

The extension calls these CLI commands internally:

Extension actionCLI command
Searchcairn search <query> --json
Listcairn list --json
Savecairn add <url> --tags <tags>
Deletecairn delete <id>
Pincairn pin <id>