# 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

```bash
# 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](LICENSE) file for details.

## Credits

Semble is being built by [Cosmik Network](https://cosmik.network/). Get involved [here](https://cosmik.network/#connect).

Learn more about Cosmik Network and Semble [here](https://blog.cosmik.network/).

## Contributing

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