Agent Platform

Agent Platform is a devcontainer-based runtime for safely configuring and running AI agents (Claude Code, OpenAI Codex, and Opencode) in an isolated environment.

Prerequisites

• Docker or a compatible container runtime.
• A devcontainer-capable environment (VS Code Dev Containers, devcontainer CLI, or compatible tooling).

Deploying

Export configuration options (optionally), then create and start the devcontainer environment.

export <configuration_option>=<value>
devcontainer up \
  --workspace-folder <workspace-path> \
  --config <path-to-devcontainer.json-file> \
  --build-no-cache

Sanity checks fails in case of security violations, but you can still use container by reloading the window.

How to use it

Please refer to How to use it wiki.

Configuration

Configuration is managed through environment variables.

Variable	Default Value	Description	Required	Type
AGENT_PLATFORM_CLAUDE_CODE_VERSION	latest	Devcontainer build arg that selects the Claude Code version.	No	String (version tag, e.g. latest or 1.2.3)
AGENT_PLATFORM_CODEX_VERSION	latest	Devcontainer build arg that selects the Codex version.	No	String (version tag, e.g. latest or 1.2.3)
AGENT_PLATFORM_OPENCODE_VERSION	latest	Devcontainer build arg that selects the Opencode version.	No	String (version tag, e.g. latest or 1.3.0)
AGENT_PLATFORM_BACKLOG_MD_VERSION	latest	Devcontainer build arg that selects the Backlog.md CLI version.	No	String (version tag, e.g. latest or 1.40.0)
AGENT_PLATFORM_BACKLOG_MD_MCP_VERSION	latest	Devcontainer build arg that selects the @radleta/backlog-md-mcp MCP server version.	No	String (version tag, e.g. latest or 0.1.10)
AGENT_PLATFORM_BEADS_VERSION	latest	Devcontainer build arg that selects the @beads/bd CLI version.	No	String (version tag, e.g. latest or 1.0.2)
AGENT_PLATFORM_CONTEXT7_VERSION	latest	Devcontainer build arg that selects the Context7 MCP server version (used by Codex and Opencode; Claude now gets Context7 via the context7 plugin).	No	String (version tag, e.g. latest or 1.0.0)
AGENT_PLATFORM_PLAYWRIGHT_MCP_VERSION	latest	Devcontainer build arg that selects the @playwright/mcp server version backing the playwright Claude plugin.	No	String (version tag, e.g. latest or 0.0.43)
AGENT_PLATFORM_ZSH_IN_DOCKER_VERSION	1.2.0	Devcontainer build arg that selects the zsh-in-docker version.	No	String (version tag, e.g. 1.2.0)
AGENT_PLATFORM_TRUFFLEHOG_VERSION	latest	Devcontainer build arg that selects the TruffleHog release pinned during image build. With latest, the version is resolved from the GitHub releases API at build time.	No	String (version tag, e.g. latest or 3.95.2)
AGENT_PLATFORM_ALLOW_INTERNET	true	Allow internet access inside the devcontainer.	No	Boolean (true/false)
AGENT_PLATFORM_ALLOW_SSH_AGENT	true	Allow SSH agent forwarding into the devcontainer.	No	Boolean (true/false)
AGENT_PLATFORM_ALLOW_HOST_NETWORK	true	Allow host network access from the devcontainer.	No	Boolean (true/false)
AGENT_PLATFORM_TZ	Europe/Warsaw	Time zone for the devcontainer.	No	String (AGENT_PLATFORM_TZ database name, e.g. Europe/Warsaw)

Options can be reapplied after the container is built by changing the options and restarting.

Currently, extension versions can’t be specified via environment variables in a devcontainer. Use the Extensions Manager to change them if necessary.

References & Documentation

• Architecture Overview
• Anthropic Claude-Code devcontainer main
• Claude Code: Best practices for agentic coding
• How to Safely Run AI Agents Like Cursor and Claude Code Inside a DevContainer
• Running codex cli in VS Code devcontainer
• Anthropic Claude-Code configuration reference
• OpenAI Codex configuration reference
• Opencode configuration reference
• Anthropic Claude-Code developer's guide

Contributing

See CONTRIBUTING.md for contribution guidelines.

License

See LICENSE for license information.