renderg.host / semble-raycast-extension
A Raycast extension to search and manage Semble Cards and Collections
fork atom
TypeScript 100.0%
1 1 0

Clone this repository

https://tangled.org/renderg.host/semble-raycast-extension
git@tangled.org:renderg.host/semble-raycast-extension

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

Semble Raycast Extension#

Search and manage your Semble Cards and Collections directly from Raycast.

Features#

  • Search Cards: Search through all your saved cards with real-time filtering
  • Search Collections: Find and access your collections quickly
  • Collection Filtering: Filter cards by specific collections
  • Quick Actions:
    • Copy card link to clipboard (primary action)
    • Visit card in browser
    • Copy original URL

Setup#

  1. Install the extension in Raycast
  2. Configure your Semble credentials:
    • Identifier: Your Semble username (e.g., renderg.host)
    • App Password: Your AT Protocol app password
    • PDS Host (optional): Your Personal Data Server host (default: bsky.social)

Using a Custom PDS#

WARNING

This is so far untested. Please raise an issue if this doesn't work for you.

If you're running your own Personal Data Server or using an alternative AT Protocol PDS provider:

  1. Open Raycast preferences (⌘+,)
  2. Navigate to Extensions → Semble
  3. In the PDS Host field, enter your custom PDS host without the protocol
    • Example: my-pds.example.com (not https://my-pds.example.com)
  4. Enter your identifier and app password as configured on your PDS
  5. Save the preferences

The extension will automatically connect to https://your-custom-host for all authentication and data operations.

Usage#

Search Cards#

Use the Search Cards command to:

  • View all your Semble cards
  • Search by title or URL
  • Filter by collection using the dropdown
  • Press Enter to copy the card link
  • Use ⌘+Enter for secondary actions

Search Collections#

Use the Search Collections command to:

  • View all your collections
  • Search by collection name
  • Press Enter to copy the collection link

Development#

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

License#

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

Credits#

Semble is being built by Cosmik Network. Get involved here.

Learn more about Cosmik Network and Semble here.

Contributing#

Contributions are welcome! Please feel free to submit a Pull Request.