Set up the Mac app

Sign in

1. In the Set up Shoyu window, click Login.
2. Your browser opens a Shoyu page. Check that it names the Shoyu app, choose the organizations it can use, and click Authorize.
3. Go back to Shoyu. It moves to the next step on its own.

If the browser page did not open, click Open Sign in. If sign-in fails, click Retry or press ↩.

Grant permissions

1. Click Open Settings next to Screen Recording. macOS opens System Settings with a small helper window.
2. Drag Shoyu from the helper into the list, or turn on Shoyu if it is already there.
3. Do the same for Input Monitoring.
4. Click Request microphone and Request camera if you want them, and allow each one.
5. When a row says Relaunch Shoyu, click it. Screen Recording and Input Monitoring only take effect after Shoyu restarts.

Set up Deep Context

This step installs the extras that add context to your recordings. Each one is optional, and Continue always works.

Set up Agent Automation

The last step lets an AI agent use Shoyu. LLM Skills installs the Shoyu skills for agents such as Claude Code and Codex. Automation lets an agent record a window or display. Turning it on asks for Touch ID or your Mac password.

Both are optional. Click Set up later to skip them, or Complete setup when you are done. Let an agent record its work explains Automation.