Skip to content

szachovy/agent-platform

Repository files navigation

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.

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

Plugins & MCP & Skills installed

From any agent invoke /instructions to get the informations on what and how to use installed extensions. For manual lookup see SKILL.md.

References & Documentation

Contributing

See CONTRIBUTING.md for contribution guidelines.

License

See LICENSE for license information.

About

Core runtime for safe configuration and deployment of AI agents.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors