> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digcrate.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get from sign-up to your first research query in under 5 minutes

<Steps>
  <Step title="Sign up at digcrate.app">
    Go to [digcrate.app](https://digcrate.app) and create an account. Sign-in is handled by Clerk — you can use email or an OAuth provider.

    On your first sign-in, a quick start wizard walks you through adding an API key. You can skip this and use the 10 free queries included on the Free plan.
  </Step>

  <Step title="Start a new session">
    Click **New Chat** in the sidebar, or press `Cmd+N`. Each session is an independent research conversation. Your sessions are saved automatically and appear in the sidebar under **Recents**.

    <Tip>
      On mobile, tap the hamburger menu to open the sidebar and start a new session.
    </Tip>
  </Step>

  <Step title="Run your first query">
    Type your question in the chat input and press **Enter**. The simplest way to start is with the `/artist` command:

    ```
    /artist MF DOOM
    ```

    The agent searches across MusicBrainz, Discogs, Last.fm, Genius, YouTube, and more, then renders an interactive **ArtistProfile** component directly in the chat. Click it to open the full profile in the **Deep Cuts** panel on the right.

    You can also ask in plain language — the agent handles both:

    ```
    Who influenced Flying Lotus?
    What's the story behind Donuts?
    Map the LA beat scene
    ```
  </Step>

  <Step title="Save research to Deep Cuts">
    When the agent returns a rich component (an artist profile, influence map, playlist, or show prep package), it automatically appears in the **Deep Cuts** panel. The panel saves everything from your current session so you can switch between results using the dropdown selector at the top.

    To share a result, click **Publish** in the Deep Cuts header. This generates a shareable link at `digcrate.app/cuts/[id]` and copies it to your clipboard.

    <Note>
      Publishing requires a Pro or Team plan. On the Free plan, results are visible only within your session.
    </Note>
  </Step>
</Steps>

## Slash commands

Type `/` in the chat input to see the full command menu. Use arrow keys to navigate and `Tab` or `Enter` to select.

| Command                       | What it does                                                                                               |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `/artist [name]`              | Full artist deep dive — tabbed discography, influence connections, media, top tracks                       |
| `/track [song] [artist]`      | Track deep dive — credits, samples (WhoSampled), lyrics (Genius), vinyl pressings (Discogs)                |
| `/influence [artist]`         | Interactive influence map tracing connections through reviews, Last.fm similarity, and Perplexity research |
| `/story [topic]`              | Narrative deep dive with chapters, YouTube embeds, key tracks, and people cards                            |
| `/prep [station]: [setlist]`  | Full radio show prep — track context, talk breaks, social copy, interview prep                             |
| `/news [station] [count]`     | Daily music news segment from RSS feeds and web search                                                     |
| `/radio [genre or station]`   | Search and stream any of 30,000+ live radio stations                                                       |
| `/create-skill [description]` | Teach Digcrate a new reusable command                                                                      |
| `/skills`                     | List, enable, disable, and edit your custom skills                                                         |
| `/publish telegraph`          | Publish research to a shareable Telegraph article (Pro)                                                    |

## Add your own API key (BYOK)

The Free plan includes 10 agent queries per month. To get unlimited queries, bring your own key from Anthropic or OpenRouter.

1. Open **Settings** (`Shift+S` or the gear icon in the sidebar).
2. Go to the **API Keys** tab.
3. Paste your Anthropic key (`sk-ant-...`) or OpenRouter key.
4. Click **Save** — your key is encrypted and stored securely.

With a BYOK key, queries run against your key with no monthly cap.

<Tip>
  OpenRouter gives you access to multiple models (GPT-4o, Gemini 2.5, Llama 4, DeepSeek R1, Mistral Large) in addition to Claude. Use the model selector in the chat header to switch.
</Tip>
