# Coworkkit

> Coworkkit adds a voice + Hand-mode AI copilot to your web app: you declare actions,
> surfaces, elements, and cues with the React SDK; Coworkkit runs the entire voice
> runtime as a closed loop (your secret key never reaches the browser). These docs
> cover the five-step integration, the declaration primitives, and operating sessions.

## Start here

- [Getting started](http://localhost:3000/docs-md/getting-started.md): Install the SDK and wire the closed-loop token route — a working voice copilot in five steps.
- [Backends](http://localhost:3000/docs-md/backends.md): Next.js is a one-line drop-in; every other JS backend mints with mintSession. Which stacks fit, and the JS-only caveat.
- [Connect your coding agent](http://localhost:3000/docs-md/coding-agent.md): Add the Coworkkit MCP server to Claude Code or Cursor: live docs with no account, then session diagnostics and config after a one-time browser sign-in.
- [How it works](http://localhost:3000/docs-md/how-it-works.md): The closed loop, end to end: what your app declares, what Coworkkit runs, and why the key never reaches the browser.

## Declaring your app

- [Actions, surfaces & elements](http://localhost:3000/docs-md/actions-surfaces.md): The four primitives — declare what the agent can do, where the user is, what it can see and operate, and how to steer it.
- [Hand mode](http://localhost:3000/docs-md/hand-mode.md): Let the agent operate the page, not just talk about it — arming, the dual-sided gate, and what stays off-limits.
- [Control & confirmation](http://localhost:3000/docs-md/control.md): Gate an action by how much it costs to get wrong: open, a spoken confirm, or a hard on-screen click the agent can't fake.

## Polish & operate

- [Appearance](http://localhost:3000/docs-md/appearance.md): Give the button your brand's accent and dot style with a look code — one prop, edited from the Studio, no redeploy.
- [The Watch panel](http://localhost:3000/docs-md/watch.md): See what the agent sees and did — live turns, the action timeline, latency — an in-app devtool you drop in during a build.

## Reference

- [Advanced](http://localhost:3000/docs-md/advanced.md): Multiple surfaces, the session lifecycle, credits and metering, and testing your integration — once the basics are wired.
- [Configuration](http://localhost:3000/docs-md/configuration.md): Every CoworkkitProvider prop and its default — FAB position and drag, the z-index escape valve, the confirmation timeout, the app-wide control baseline, and the wiring props.
- [Browser & framework support](http://localhost:3000/docs-md/compatibility.md): Which browsers work (Chromium, Safari, Firefox), the mic + WebRTC requirement, the mobile story, and the React / Next.js versions the SDK supports.
- [Troubleshooting & FAQ](http://localhost:3000/docs-md/troubleshooting.md): The agent connects but is silent, the mic is blocked, the button never appears — the usual first-run snags and their fixes.