Raycast Karakeep

A Raycast extension for Karakeep, a self-hostable bookmark manager with AI-powered tagging. Save, search, and manage your bookmarks, notes, and highlights without leaving Raycast.

This extension leverages Karakeep's API to provide a streamlined experience for managing your digital collection, complete with AI-powered tagging and search capabilities.

📥 Installation

Option 1: Raycast Store

• Install directly from Raycast Store: Karakeep

Option 2: Manual Installation

git clone https://github.com/foru17/raycast-karakeep.git
cd raycast-karakeep
npm install && npm run dev
# Enjoy it

✨ Features

Core Features

• Quick Access to Bookmarks: Instantly view and access your saved bookmarks, screenshots, and content
• List Management: Browse and organize bookmarks through customized lists
• Tag Organization: Efficiently manage and filter content using tags
• Fast Bookmark Creation: Create new bookmarks directly from Raycast with just a few keystrokes

Additional Conveniences

• Intuitive Search: Quickly locate any bookmark or content using the online search feature of Karakeep and the powerful search capabilities of Raycast.
• One-Click Actions: Open bookmarks in your browser, copy links, or delete instantly.
• Preview Support: View bookmark details and screenshots without leaving Raycast
• Keyboard Navigation: Fully keyboard-accessible for maximum efficiency
• Customizable Display: Set up your preferred information display for bookmarks

Commands

• Create Bookmark — Add a new URL bookmark, optionally prefilled from your active browser tab.
• Quick Bookmark — Instantly bookmark the current browser tab with a single hotkey.
• Create Note — Add a new text note.
• Bookmarks — Browse, search, and manage your full bookmark collection. Filter by list, favorite, archive, summarize with AI, and copy links.
• Lists — Create, edit, and delete lists including smart lists with query-based filtering.
• Tags — Create, rename, and delete tags.
• Notes — View and manage text notes (bookmarks of type "text").
• Highlights — View, edit, and delete highlights saved from web pages.
• Backups — Create, download, and delete account backups. Backup status updates automatically — the list polls while a backup is in progress.
• My Stats — Overview of your library: bookmark counts by type, top domains, top tags, activity over time, and storage usage with charts.

Browser Extensions

Install the Karakeep browser extension to save pages directly from your browser and create highlights. Links to Chrome, Firefox, and Safari extensions are available from the Actions panel on any bookmark.

• Chrome Extension
• Firefox Add-on
• Safari Extension

Prerequisites

Before you begin, ensure you have the following:

• A running Karakeep instance
• A Karakeep API key — create one at https://your-karakeep-instance.com/settings/api-keys
• Raycast installed

It is strongly recommended to set up Karakeep with Docker for easy deployment and management.

Configuration

1. Open Raycast Preferences → Extensions → Karakeep
2. Enter your Karakeep API URL and API key

You can also customize default actions for link and text bookmarks, and choose which bookmark details to display (tags, description, note, summary, creation date, preview image).

Troubleshooting

1. Verify your API URL and key are correct
2. Ensure your Karakeep instance is running and accessible

If problems persist, open an issue on GitHub.

👥 Contributing

Contributions are welcome and appreciated! Here's how you can contribute:

1. Fork the repository
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request

Credits

Built on top of the Karakeep project.

Thanks to @kdurek for the original Raycast Karakeep extension, and to @foru17 for the enhanced version this is based on.

License

MIT — see LICENSE for details.