ramalama-sandbox(1)

💖 ramalama-sandbox — the ramalama-sandbox(1) glow-up 💖

ok so bestie, welcome to the General Commands Manual era of your life. this is the page for ramalama-sandbox, and it's giving "put an AI agent in a little container jail and let it cook with a local model". let's go 🫶

---

✨ NAME ✨

ramalama-sandbox — run an AI agent in a sandbox, backed by a local AI Model 🌸

---

🎀 SYNOPSIS 🎀

ramalama sandbox agent [options] model [arg ...]

---

🦋 DESCRIPTION 🦋

okay so here's the vibe: you run an AI agent inside a container, and it's connected to a local model server that's also chillin' in a container — or, plot twist, it can point at an llm-endpoint url instead. either way, the agent uses that model for its reasoning and its tool calling. main character energy, no cap. 💅

the agent argument is literally you picking which AI agent gets to run. rn, the supported agents are:

• goose — the Goose AI agent (https://github.com/aaif-goose/goose)
• opencode — the OpenCode AI agent (https://opencode.ai/)
• pi — the Pi AI coding agent (https://github.com/earendil-works/pi)

---

⭐ OPTIONS ⭐

• --help, -h — show this help message and exit. that's it, that's the whole option. slay 🎀

---

👑 SUBCOMMANDS 👑

each of these is its own whole entire man page, iykyk. go read the one you need:

• goose — see ramalama-sandbox-goose(1) — run Goose in a sandbox, backed by a local AI Model 🦢
• opencode — see ramalama-sandbox-opencode(1) — run OpenCode in a sandbox, backed by a local AI Model 💻
• pi — see ramalama-sandbox-pi(1) — run Pi in a sandbox, backed by a local AI Model 🥧

---

🌈 SEE ALSO 🌈

• ramalama(1)
• ramalama-run(1)
• ramalama-serve(1)

go read those too, they're all part of the same friend group fr fr ✨

---

💀 HISTORY 💀

Mar 2026 — originally compiled by Mike Bonnet mikeb@redhat.com ⟨mailto:mikeb@redhat.com⟩ 🔥

---

and that's the whole page bestie!! 🥰 tysm for reading ramalama-sandbox(1) from the General Commands Manual — go forth and sandbox your agents, you're doing amazing sweetie 💖🌸🦋💅