Use Teak in Raycast to save ideas and find cards without leaving your keyboard flow.

## Quick setup

1. Install the extension:

[![Install teak-raycast Raycast Extension](https://www.raycast.com/praveenjuge/teak-raycast/install_button@2x.png?v=1.1)](https://www.raycast.com/praveenjuge/teak-raycast)

2. Run any Teak command and choose **Sign in with Browser**. Your browser opens to authorize Teak, then returns you to Raycast — no key to copy.

### Using an API key (optional)

Prefer an API key? Open the extension preferences and paste a key from Teak Settings → **Manage API Keys**. A configured API key takes precedence over browser sign-in, so existing setups keep working unchanged.

## Commands

- **Quick Save**: Open an input form to type or paste text and URLs to save.
- **Save to Teak**: Save any text or URL in one step. Accepts an optional argument and works as a [Raycast fallback command](https://manual.raycast.com/fallback-commands), so pressing Enter on a root search with no results can save that query straight to Teak.
- **Save Clipboard**: Save the current clipboard contents to Teak with no prompt.
- **Save Selected Text**: Save the text currently highlighted in any app. Ideal paired with a global hotkey.
- **Save Current Browser Tab**: Save the active browser tab directly from Raycast. Requires the [Raycast Browser Extension](https://www.raycast.com/browser-extension).
- **Search Cards**: Find and open cards instantly.
- **Favorites**: Jump to your starred cards.
- **Browse Tags**: See every tag in your vault with per-tag card counts, then drill into a tag to search within it.

## AI Tools

Teak exposes the following tools for [Raycast AI](https://www.raycast.com/ai):

| Tool                      | What it does                                                      |
| ------------------------- | ----------------------------------------------------------------- |
| **Save to Teak**          | Save a note or URL to your Teak library.                          |
| **Search Teak Cards**     | Search cards by text, type, tags, favorite state, and sort order. |
| **Get Recent Teak Cards** | Fetch the newest cards without a search query.                    |
| **Get Teak Card**         | Fetch the full details of a specific card by ID.                  |
| **List Teak Tags**        | List your tags with per-tag card counts.                          |
| **Toggle Favorite**       | Favorite or unfavorite a card. Requires confirmation.             |

AI tools use the same sign-in as the extension — no extra setup required.

## Security

- Browser sign-in connects Raycast to your Teak account without copying a key. Use **Sign Out** from any command's action panel to disconnect.
- If you use an API key instead, it only connects Raycast to your Teak account. Revoke, disable, or regenerate it anytime from Teak Settings.