When something doesn't go to plan, start here. Each problem below has one fix that resolves it most of the time.
A recording won't finish uploading
A recording streams to the cloud as it's captured, and a local copy is kept until the server confirms receipt — so the audio is safe even when the upload stalls. A stalled upload resumes on its own once the connection is healthy.
Fix: confirm you're online, then reopen the app or web recorder. The held chunks finish uploading from where they left off. Don't delete the recording — that's the one thing that can lose the audio that hasn't confirmed yet.
Can't sign in
Sign-in fails most often because of a stale session, not a wrong password.
Fix: sign out fully, then sign back in with the same account you use on the web. If a CLI command reports an auth error, refresh your token:
Cast handoff failed
A cast can fail to connect when the phone and the TV aren't on the same Wi-Fi network, the TV is asleep, or the target is an audio-only device.
Fix: put both devices on the same Wi-Fi, wake the TV so it's ready to receive, and pick a video-capable target — Apple TV, Chromecast, or a Roku. HomePods and other audio-only AirPlay devices can't render the stream and are hidden as targets. See cast to a TV.
Recording seemed to stop
SageOx never ends a recording silently — if it stopped, the app told you.
Recording continues when you lock the phone or switch apps. On iPhone, a Lock Screen Live Activity keeps showing the recording is running, with a working Stop — it stays up even if the app itself was closed. On Android, an ongoing notification does the same job.
Fix: check the Lock Screen (iOS) or the notification shade (Android). If the recording indicator is still there, you're still recording — reopen the app to confirm. If it's gone, the recording already ended: either Stop was tapped, or the app surfaced an error at the moment it happened.
Notes or context aren't generating
Transcription and extraction run after a recording completes. If nothing appears, the recording usually hasn't finished uploading, or it captured no speech.
Fix: check the recording reached uploaded in your team's Media section. A silent recording produces no transcript and therefore no summary or decisions — narration is what the pipeline reads.
Never delete a recording to "reset" a stuck upload. The local copy is your safety net until the server confirms receipt — deleting it can lose audio that hasn't uploaded.
What's next
- Get the most out of SageOx — the habits that keep things smooth.
- Context capture overview — how recordings become context.
- ox doctor — diagnose CLI and connection issues.
Get the most out of SageOx
A chronological guide — from first setup to advanced habits — for turning conversations into context your whole team uses.
Cookbooks
Step-by-step workflow recipes for SageOx. Import Loom, Figma, and Cap recordings, and run AI agent factories with OpenClaw. Build team knowledge that compounds over time.