> ## 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.
# Workspace overview
> How the chat panel, Deep Cuts, and audio player work together
The Digcrate workspace is a split-pane layout. The **chat panel** occupies the left side where you send queries and read responses. The **Deep Cuts panel** opens on the right and displays interactive research components. A persistent **audio player** bar sits at the bottom of the screen.
Send queries, run slash commands, and watch the agent work in real time.
Save, browse, and publish interactive research components — artist profiles, influence maps, playlists, and more.
Persistent YouTube and live radio playback that keeps running as you research.
## Chat panel
The chat panel is where all research starts. Type a question or slash command and press **Enter** to submit.
### Starting a query
The input placeholder reads "Who influenced Flying Lotus? Try / for commands" when idle and "Crate is researching..." while the agent is running. You can also click one of the suggestion chips on an empty session to prefill a starter query.
### Slash command syntax
Type `/` to open the command autocomplete menu. The menu filters as you type and shows each command's usage syntax. Press arrow keys to navigate, then `Tab` or `Enter` to select.
Most commands take a single argument directly after the command name:
```
/artist Erykah Badu
/influence J Dilla
/track So What Miles Davis
/story Kind of Blue
```
The `/prep` and `/show-prep` commands open a structured form where you pick a station, shift, and setlist instead of typing everything inline.
### Streaming tool progress
While the agent is running, the chat panel shows a live activity feed labeled **Crate**. Each tool call appears as it starts (with an animated pulse dot) and gets a checkmark when it completes. The feed clears when the response finishes streaming.
When the agent generates a rich component (an ArtistProfile, InfluenceChain, ShowPrepPackage, etc.), a compact preview card appears inline in the chat. Click the card to open the full component in Deep Cuts.
Plain-language questions and short conversational messages go to a lightweight chat tier and do not consume an agent query from your monthly quota.
## Deep Cuts panel
Deep Cuts is a resizable panel on the right side of the workspace (desktop) or a full-screen view (mobile). It renders interactive research components using [OpenUI](https://github.com/thesysdev/openui) — the same rendering engine the agent uses to generate them.
### Saving research
The agent automatically pushes each generated component to Deep Cuts. You do not need to manually save — every result from the current session is available in the panel history.
### Dropdown selector with type-colored dots
The header of the Deep Cuts panel contains a dropdown that lists every result from the current session. Each item shows a colored dot indicating its type:
| Color | Type |
| ------ | -------------- |
| Violet | Influence map |
| Cyan | Artist profile |
| Green | Playlist |
| Amber | Show prep |
| Gray | Other research |
Click any item in the dropdown to switch to it. The current item label and dot color are always visible in the collapsed header.
### Action buttons
Each result type shows relevant action buttons next to the dropdown:
* **Spotify** — Open a playlist or artist in Spotify (requires Spotify connected in Settings)
* **Export** — Export an influence chain to a new Spotify playlist
* **Slack** — Send the result to a Slack channel (requires Slack connected in Settings)
* **Publish** — Generate a shareable public link at `digcrate.app/cuts/[id]`
Clicking **Publish** calls the API, generates the share URL, and copies it to your clipboard. The button label changes to "Copied!" to confirm. Published Deep Cuts render with the audio player so anyone with the link can listen.
Publishing requires a Pro or Team plan.
## Audio player
A persistent player bar sits at the bottom of the workspace. It plays YouTube videos and live radio streams without leaving the page.
### YouTube playback
When a component contains a playable track or the agent fetches a music video, it triggers playback automatically via the YouTube IFrame API. The player bar shows the track title and artist. A hidden YouTube iframe handles actual playback — you interact with it through the player bar controls only.
### Live radio
The `/radio` command searches Radio Browser's catalog of 30,000+ stations and calls `play_radio` to start streaming. The player bar switches to show the station name and a "Live Radio" label. Use `/radio [genre or station name]` — for example `/radio KEXP` or `/radio jazz`.
### Mobile player
On mobile, the player bar is a compact mini-player. It hides automatically when the keyboard is open so it does not overlap the input.
## Keyboard shortcuts
| Shortcut | Action |
| --------- | ------------------------------ |
| `Cmd+K` | Focus the sidebar search bar |
| `Cmd+N` | Start a new chat session |
| `Cmd+B` | Toggle the sidebar open/closed |
| `Shift+S` | Open Settings |
## Mobile layout
On small screens the workspace switches to a single-column layout.
Tap the menu icon in the mobile header to open the sidebar as a full-screen overlay. Tap outside or navigate to a session to close it.
Deep Cuts opens as a full-screen view rather than a side panel. Horizontal tabs let you navigate between saved results.
A mic button appears above the input on mobile. Tap it to dictate your query using the Web Speech API. The transcript is appended to the input field.
The chat input uses a pill shape on mobile with 44px+ touch targets throughout the interface.
Digcrate is designed to wrap as an iOS app via Capacitor. The mobile layout is optimized for native-feeling touch interactions.