docs(examples): agent-bundle image — 10 coding agents on node base

[G4614]

Summary

Adds examples/agent-bundle/ — a reference Dockerfile (+ README) that bundles ten terminal coding agents into one box image on top of the curated boxlite-agent-node base.

Agents: Claude Code, Codex CLI, Gemini CLI, Copilot CLI, OpenCode, raft, Kimi Code, Pi (npm) + Cursor CLI and Antigravity CLI (native, curl installers).

Why the node base

boxlite-agent-node already ships Node 22 + npm + python3/pip + git/curl, so both the npm CLIs and the two native agents run without extra runtimes. The base and python curated images have no Node, so the npm-majority can't install there.

Notes / non-obvious bits

• Native agents relocated to /opt/agents — their installers drop payloads under $HOME/.local (root-only 0700), which the unprivileged boxlite user can't reach; that otherwise leaves Cursor unusable and ~200 MB stranded under /root.
• HOME scoped to the installer RUN; final image uses HOME=/home/boxlite so agents can write config/cache as the box user.
• node_modules slimmed (source maps, docs, tests, changelogs).

Measured (linux/amd64)

	Size
On disk	~3.34 GB
Compressed (pull)	~821 MB

All ten CLIs smoke-checked to resolve on PATH at build time, and each returns --version when run as the box user.

Draft: opening for review of placement/approach. Package pins are @latest-ish; pin exact versions before any non-example use.

[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: 200cc5bc-1a3c-4474-898f-bb9344e4aeff

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch agent-bundle-image

---

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.}

[cla-assistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.

---

nyquist1773 seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[cla-assistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.

---

nyquist1773 seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}