Orquesta Embed SDK

Embed Orquesta AI-powered development UI into any production website.

Features

• 🎯 Element Selection - Right-click any element to prompt about it
• 📋 Console Capture - Auto-include console logs in prompts
• 🌐 Network Capture - Include network errors for debugging
• 📊 Timeline - View prompt history and status
• 🚀 Deployments - See current deployment status
• 🎨 Customizable - Position, theme, features

Installation

React

npm install orquesta-embed

import { OrquestaEmbed } from 'orquesta-embed'
import 'orquesta-embed/styles.css'

function App() {
  return (
    <>
      <YourApp />
      <OrquestaEmbed
        token="oek_xxxxx"
        position="bottom-right"
        captureConsole={true}
        captureNetwork={true}
        onReady={() => console.log('Orquesta ready!')}
      />
    </>
  )
}

Vanilla JavaScript

<script src="https://cdn.orquesta.live/embed/v1/orquesta.min.js"></script>
<script>
  const widget = Orquesta.init({
    token: 'oek_xxxxx',
    position: 'bottom-right',
    captureConsole: true,
    captureNetwork: true,
    onReady: () => console.log('Orquesta ready!')
  });

  // Programmatic API
  widget.open();
  widget.close();
  widget.toggle();
  widget.startElementSelection();
  widget.submitPrompt('Fix this bug', { includeConsole: true });
  widget.destroy();
</script>

Configuration

| Option | Type | Default | Description | |--------|------|---------|-------------| | token | string | required | Your embed token (oek_xxx) | | position | 'bottom-right' \| 'bottom-left' \| 'top-right' \| 'top-left' | 'bottom-right' | Panel position | | defaultOpen | boolean | false | Start with panel open | | theme | 'dark' \| 'light' \| 'auto' | 'dark' | Color theme | | features | Feature[] | All features | Enabled features | | captureConsole | boolean | true | Capture console.log/error | | captureNetwork | boolean | true | Capture fetch/XHR errors | | hotkey | string | 'ctrl+shift+o' | Keyboard shortcut to toggle | | onReady | () => void | - | Called when connected | | onPromptSubmit | (promptId: string) => void | - | Called when prompt submitted | | onError | (error: Error) => void | - | Called on errors |

Getting Your Token

1. Go to your project settings on orquesta.live
2. Navigate to Settings > Embed
3. Click Generate Token
4. (Optional) Add domain restrictions

Security

• Embed tokens can be restricted to specific domains
• Tokens only allow submitting prompts and viewing data
• No access to credentials or sensitive settings
• Rate limited to prevent abuse

License

MIT