🚀 Raycast Hoarder

A user-friendly Raycast extension that seamlessly integrates with Hoarder, bringing powerful bookmark management to your fingertips. Quickly save, search, and organize your bookmarks, texts, and images—all through Raycast's intuitive interface.

This extension leverages Hoarder'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 (Coming Soon)

• Install directly from Raycast Store: Hoarder Bookmark Manager

Option 2: Manual Installation

git clone https://github.com/foru17/raycast-hoarder.git
cd raycast-hoarder
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 Hoarder 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

All powered by Hoarder's robust API, bringing your bookmark management right into Raycast's streamlined interface.

📑 Prerequisites

Before you begin, ensure you have the following:

• A deployed Hoarder instance (follow the Hoarder installation guide)
• Hoarder API credentials
• Raycast installed on your macOS system

I strongly recommend setting up Hoarder with Docker for easy deployment and management.

Create an API key by visiting https://your-hoarder-instance.com/settings/api-keys and clicking the 'New API Key' button.

🚦 Configuration

After installation, set up the extension with your Hoarder instance details:

1. Open Raycast Preferences
2. Navigate to the Extensions tab
3. Find "Hoarder" in the list of installed extensions
4. Enter your Hoarder API URL and authentication credentials

You can also customize the default main operations and the bookmark details you want to display.

🎯 Usage

Here's how to make the most of the Raycast Hoarder extension:

• View All Bookmarks: Access your complete bookmark collection
• Search Content: Utilize full-text search across all bookmarked content
• AI Tagging: Automatically categorize bookmarks using AI
• Create New Bookmarks: Add new bookmarks with ease
• Edit Bookmarks: Edit bookmark title and notes

🔧 Troubleshooting

If you encounter any issues:

1. Verify your Hoarder API credentials are correct
2. Ensure your Hoarder instance is running and accessible
3. Check the Raycast console for error messages
4. Verify your AI service configuration if using automatic tagging

If problems persist, please open an issue on the GitHub repository.

👥 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

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

🙏 Credits

This extension is built on top of the Hoarder project. We're grateful for their work in creating such a powerful and flexible bookmarking solution.

Special thanks to @kdurek for creating the original Raycast Hoarder extension, which laid the foundation for this enhanced version.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⭐ Support

If you find this extension helpful, consider:

• Starring the GitHub repository
• Sharing it with others who might find it useful
• Contributing to the project's development

Your support helps keep this project active and improving!