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

# WorkBuddy Docs

> Enable real-time voice conversations with an AI agent in your web or Flutter application.

## How It Works

Stream audio over WebSocket — no complex SDKs required. The integration follows three simple steps:

<CardGroup cols={3}>
  <Card title="1. Get Token" icon="key">
    POST your API key to receive a short-lived session token.
  </Card>

  <Card title="2. Connect WebSocket" icon="plug">
    Open a WebSocket and authenticate with your token.
  </Card>

  <Card title="3. Stream Audio" icon="microphone">
    Send mic audio and receive AI responses as raw PCM.
  </Card>
</CardGroup>

## Documentation

<CardGroup cols={2}>
  <Card title="Getting Started" icon="rocket" href="/getting-started">
    Prerequisites, environment setup, and security best practices.
  </Card>

  <Card title="Authentication" icon="lock" href="/authentication">
    Obtain a session token using your API key.
  </Card>

  <Card title="WebSocket Protocol" icon="arrows-left-right" href="/websocket">
    Connection flow, message types, and audio format specification.
  </Card>

  <Card title="Web Guide" icon="browser" href="/web-guide">
    Full JavaScript/TypeScript implementation with Web Audio API.
  </Card>

  <Card title="Flutter Guide" icon="mobile" href="/flutter-guide">
    Complete Dart implementation with platform setup for Android and iOS.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/troubleshooting">
    Error codes, common issues, and reconnection strategies.
  </Card>
</CardGroup>