Set up Cloud Agent dev environment + AGENTS.md notes

[bitsfdb]

Summary

Sets up and verifies the Cloud Agent development environment for VelocityRL (Tauri 2 desktop app) and documents durable, non-obvious setup guidance in AGENTS.md.

No application code was changed — this only adds AGENTS.md.

What was set up (baked into the environment snapshot)

• Tauri Linux GUI system libs: libwebkit2gtk-4.1-dev, libgtk-3-dev, libayatana-appindicator3-dev, librsvg2-dev, patchelf.
• Node deps via npm install (this is also the startup update script).
• Rust toolchain set to stable (≥ 1.85) via rustup — the committed Cargo.lock pins deps requiring edition2024, so the default preinstalled 1.83 was too old.

Verified

Component	Command	Result
Rust/Tauri build	cd src-tauri && cargo build	✅ compiles (warnings only)
Lint	cd src-tauri && cargo clippy	✅ warnings only (CI itself runs cargo check --release)
Run (dev)	DISPLAY=:1 npm run dev	✅ GUI launches; staged an item swap (Octane → Fennec)
Python CLI	python3 python/cli.py --config	✅ imports engine + runs

Automated tests: none exist in this repo.

Hello-world demo

Launched the app, accepted the privacy dialog, searched the bundled item database, selected an owned item (Octane) and a target asset (Fennec), and confirmed the "Swap Items" action became enabled. Executing a real swap requires Rocket League .upk game files that aren't available in the VM; everything up to staging the swap works offline.

velocityrl_item_swap_demo.mp4

Swap staged with Octane and Fennec, Swap Items enabled

_{To show artifacts inline, enable in settings.}

  

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d13fa850-51d9-4708-9311-18546fc865bd

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}