boopmark

A fast, self-hostable bookmark manager for humans and AI agents.

Built with Rust, HTMX, and Tailwind CSS. Save, tag, and search your bookmarks from a clean web UI, a CLI (boop), or let your AI coding agents do it for you. Optional AI enrichment auto-generates tags and descriptions. Pluggable screenshot capture for page thumbnails.

---

Installation

For humans

Tell your AI coding agent:

Read https://raw.githubusercontent.com/willisrocks/boopmark/main/README.md and follow the installation instructions.

Or follow the Quick Start and CLI sections below.

For AI agents

Claude Code plugin

Install the Boopmark plugin to give Claude Code the boop skill:

claude plugin add willisrocks/boopmark

This adds the boop skill, which Claude Code will automatically use when you ask about bookmarks.

CLI setup (all agents)

Any AI agent with shell access can use the boop CLI directly:

# 1. Install the binary
curl -fsSL https://raw.githubusercontent.com/willisrocks/boopmark/main/install.sh | sh

# 2. Point at your Boopmark server (local or hosted)
boop config set-server http://localhost:4000          # local dev
# or
boop config set-server https://boopmark.yourdomain.com  # your hosted instance

# 3. Get your API key: log in to the Boopmark web app → Settings → Generate API Key
boop config set-key YOUR_API_KEY

# 4. Verify
boop list

Important: You need a running Boopmark server and a user account before the CLI will work. See Quick Start to set one up, then log in to the web app to generate your API key under Settings.

To give Claude Code (or any AI agent) access without the plugin, add this to your project's CLAUDE.md or AGENTS.md:

## Bookmarks

Use the `boop` CLI to save and search bookmarks:
- `boop add <url> --tags "tag1,tag2"` — save a bookmark
- `boop search <query>` — find bookmarks
- `boop list` — list recent bookmarks
- `boop add <url> --suggest` — save with AI-suggested tags and description

Features

• Save and tag bookmarks with automatic metadata extraction
• Full-text search across titles, descriptions, and URLs
• AI enrichment via Anthropic Claude (auto-tagging, descriptions)
• CLI client (boop) for terminal and agent-based bookmark management
• Claude Code skill support — agents can save and search bookmarks
• Optional screenshot capture via Playwright sidecar
• Invite-only access control with admin panel
• Import/export (JSONL, CSV, Netscape HTML)
• S3-compatible image storage (local disk or RustFS/AWS S3/R2)

Quick Start (Self-Hosting)

The fastest path uses Docker Compose and just bootstrap:

# 1. Prerequisites: Docker, just, openssl
git clone https://github.com/chrisfenton/boopmark
cd boopmark

# 2. Bootstrap: generates secrets, starts services, creates your owner account
just bootstrap [email protected] --password yourpassword

# 3. Open http://localhost:4000 and sign in

just bootstrap copies .env.example to .env, generates random secrets, starts the Docker stack, waits for readiness, and creates your owner account in one step.

Configuration

Copy .env.example to .env and customize. Only three variables are required; everything else has sensible defaults.