--- title: Namazu Agent Overview description: "The Namazu Agent is an AI coding agent that runs inside Namazu Cloud as a managed, on-demand job. It is purpose-built to help build and extend Namazu Elements projects, whether that work is server-side code, dashboard UI plugins, static web…" url: "https://namazustudios.com/docs/namazu-agent/namazu-agent/" updated: "2026-09-23" category: Namazu Agent --- # Namazu Agent Overview The Namazu Agent is an AI coding agent that runs inside Namazu Cloud as a managed, on-demand job. It is purpose-built to help build and extend Namazu Elements projects, whether that work is server-side code, dashboard UI plugins, static web content, or the front-end game/client code that talks to them. Start a [Session](https://namazustudios.com/glossary/session/) from the Namazu Cloud control panel, and the agent gets to work against your project in its own workspace. ![](https://namazustudios.com/wp-content/uploads/2026/09/image-6-1024x531.png) --- ## What the Agent Does for You The agent is a pair programmer, a deployment assistant, and an instance administrator in one. It can write code, commit and push changes, open pull requests, spin up disposable preview instances, and operate your running copy of Namazu Elements. ### Code and Administer in One Place Because it runs within Namazu Cloud, the agent does more than edit files. With access to your running project it can administer your live instance, manage deployments, talk to the Elements [REST](https://namazustudios.com/glossary/rest/) API, and make changes to your game end to end without you touching a console. ### Diagnose and Troubleshoot The same [Session](https://namazustudios.com/glossary/session/) that writes your code can diagnose live issues. It reads real logs, queries the actual databases and services, and works against your instance's own API to figure out what went wrong and fix it, rather than guessing from a stack trace alone. ### Temporary Preview Instance On demand, the agent can spin up (and tear down) its own temporary Namazu Elements + MongoDB instance, a disposable copy of your main setup for previewing changes safely. Anything you break there is broken only in the sandbox, never in your real deployment. See [Common Agent Tasks](namazu-agent-common-tasks) for the full workflow. --- ## Bring Your Own Agent The Namazu Agent is not tied to a single vendor. It is built on top of three leading coding agents, selectable when you deploy, all working with the same custom configuration and MCP tools built into the execution environment: - **opencode** (the default) - **OpenAI Codex** (the `codex` CLI) - **Anthropic Claude Code** (the `claude` CLI) Whichever you choose, the agent keeps the same workflow: an onboarding-aware workspace, a project clone from GitHub, a temporary preview instance, and the ability to push, pull, and open pull requests on your behalf. ### Model Options Two ways to power an agent [Session](https://namazustudios.com/glossary/session/), depending on the work and your budget: - **Bundled local/hosted models on GPU instances.** A local model (for example **Qwen 3.8B**) runs on the GPU instance that hosts your [Session](https://namazustudios.com/glossary/session/), with no API key or outside account needed. It is typically the best value for budget-friendly work, troubleshooting, and instance administration. - **Your own API key or account.** For deep and complex coding tasks, use the official opencode, Codex, or Claude Code tooling with your own API key. You can log in to your existing accounts through the agent, or supply an API key directly. --- ## How Sessions Run Each agent [Session](https://namazustudios.com/glossary/session/) runs as a job dispatched and managed by [Namazu Conductor](namazu-conductor), the Elements orchestration engine. Conductor launches the [Session](https://namazustudios.com/glossary/session/), gives it its workspace, and tracks its state. It is also how the [Session](https://namazustudios.com/glossary/session/) is visible from the Namazu Cloud control panel, where you can watch and stop it at any time (see the [Namazu Conductor Admin API](namazu-conductor-admin-api) for the underlying job model). ### Cost and Lifecycle Agent sessions are not always on. Each one is a per-job compute cost, not a standing [Service](https://namazustudios.com/glossary/service/), and an idle [Session](https://namazustudios.com/glossary/session/) winds itself down automatically after a period of inactivity, so leaving a [Session](https://namazustudios.com/glossary/session/)'s tab open does not leave the meter running. You can also stop a [Session](https://namazustudios.com/glossary/session/) manually from the control panel whenever you are done with it. --- ## Related Pages - [Common Agent Tasks](namazu-agent-common-tasks): the end-to-end workflow: launching a [Session](https://namazustudios.com/glossary/session/), GitHub auth, workspace setup, a temporary preview instance, and the development loop through to production - [Namazu Conductor](namazu-conductor): the orchestration engine that dispatches and manages agent sessions - [Namazu Conductor Admin API](namazu-conductor-admin-api): the job model behind [Session](https://namazustudios.com/glossary/session/) state and control-panel visibility - [Deploying an Element](deploying-an-element): what a finished, deployable [Element](https://namazustudios.com/glossary/element/) looks like