[kyzer1023]

Summary

• Documents how Cloud Agents should use the already running Cap web stack (Next.js, media server, MySQL, and MinIO).
• Calls out commands to avoid: bun run dev, bun run docker:up, and a second drizzle-kit push, which misbehaves in this environment.
• Notes that native crates link a source-built FFmpeg 7.1 in /usr/local because Ubuntu 24.04's FFmpeg 6.1 dev packages are too old for ffmpeg-sys-next 7.1.3. Apt libavcodec-dev is not installed. Also listed: clang, libclang-dev, nasm, pkg-config, PipeWire, ALSA, X11/xcb, GBM, DRM, Vulkan, Wayland, and EGL.
• Compile checks: cargo check -p cap-recording, cargo check -p cap-rendering, and cargo check -p cap-enc-ffmpeg. cargo test -p cap-recording --lib --tests --no-run compiles the test binaries. The full cargo test -p cap-recording --no-run also builds examples and fails on Linux because crates/recording/examples/real-device-test-runner.rs defines check_permissions only for macOS and Windows.

Test plan

• Signed in at http://localhost:3000/login with an email code printed by the web server, then created an organization
• cargo test -p cap-cursor-info (10 tests)
• cd apps/web && bun run test -- __tests__/unit/transcript-text.test.ts (9 tests)
• cargo check -p cap-recording, cargo check -p cap-rendering, and cargo check -p cap-enc-ffmpeg
• cargo test -p cap-recording --lib --tests --no-run
• Review the new AGENTS.md section for accuracy