containerized-strands-agents AGENTS.md

containerized-strands-agents AGENTS.md is an instructions file for Codex, OpenCode from mkmeral/containerized-strands-agents. It costs 3,526 tokens per session, scanned C, original, MIT.

Project instructions for a server that runs independent Strands AI agents inside Docker containers. Each agent has an isolated workspace, saved conversation history, configurable prompts and tools, and optional GitHub and web interfaces.

In plain words
What is it for?
Use them when developing, building, testing, or deploying the containerized agent server, its Docker runner, command-line tools, optional web UI, or GitHub Actions integration.
Why use it?
They explain where the server, agent logic, Docker runner, interface, tests, and build scripts live. This helps an agent work within the container lifecycle and session-persistence design.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/mkmeral/containerized-strands-agents/agents-md
Clone the repo
git clone --depth 1 https://github.com/mkmeral/containerized-strands-agents

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for containerized-strands-agents AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/mkmeral/containerized-strands-agents/agents-md.svg)](https://agentmods.dev/instructions/mkmeral/containerized-strands-agents/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/mkmeral/containerized-strands-agents/agents-md"><img src="https://agentmods.dev/badge/instructions/mkmeral/containerized-strands-agents/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,526 This file is loaded in full into every session.
When invoked 3,526 The same file — it is already loaded in full.
Security scan C 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.03526 $0.03526
Opus 5 $0.01763 $0.01763
Sonnet 5 $0.00705 $0.00705
Haiku 4.5 $0.00353 $0.00353

Measured 5d ago against content hash cf71698ae995, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

containerized-strands-agents AGENTS.md scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reaches for credential fileshighPrivilege escalation

SSH keys, cloud credentials, git-credentials, .npmrc, /etc/shadow: reading these is how a config file becomes a credential leak.

- `~/.aws/credentials` (read-only mount)
AGENTS.md · 366 lines

How it starts

The opening of the file, as written. The whole thing — 366 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Project Overview

Containerized Strands Agents is an MCP (Model Context Protocol) server that hosts isolated Strands AI agents in Docker containers. Each agent runs independently with its own workspace, persists conversation history across restarts, and supports custom system prompts, per-agent tools, and GitHub integration. The fire-and-forget architecture enables autonomous background task execution while the host manages container lifecycle, idle timeouts, and session persistence.

Repository Structure

  • src/containerized_strands_agents/ — Core package:
    • server.py — MCP server (FastMCP tools)
    • agent_manager.py — Docker orchestration, container lifecycle
    • agent.py — Shared agent logic (create_agent, run_agent)
    • cli.py — CLI commands (snapshot, restore, run)
    • config.py — Configuration constants
  • docker/ — Docker image: FastAPI runner, GitHub tools, requirements
  • ui/ — Optional web UI: FastAPI REST wrapper and HTML interface
  • scripts/ — Shell scripts for building Docker image and running the server
  • tests/ — Unit, integration, and end-to-end tests using pytest
  • templates/ — GitHub Actions workflow template for running agents in CI
  • .github/workflows/ — CI and PyPI publishing workflows
  • data/ — Runtime persistence (gitignored): agent workspaces, sessions, task registry

Build & Development Commands

# Install in development mode
pip install -e ".[dev]"

# Install with web UI support
pip install -e ".[webui]"

# Or use Makefile
make dev              # Install with all dependencies
make test             # Run unit tests
make test-all         # Run all tests (requires Docker)
make build            # Build wheel and sdist
make docker           # Build Docker image

# Build Docker image (auto-built on first use, or manually)
./scripts/build_docker.sh

# Run MCP server (for use with Kiro, Claude Desktop, etc.)
containerized-strands-agents-server
# or
python -m containerized_strands_agents.server

# Run web UI (finds free port 8000-8100)
containerized-strands-agents-webui

# Run tests
python -m pytest tests/ -v

Read the full file on GitHub · 366 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 366 lines · 3,526 tokens per session scan C cf71698ae995

Subscribe to this mod's changes

containerized-strands-agents AGENTS.md is an instructions file published in the GitHub repository mkmeral/containerized-strands-agents (3 stars, last pushed 3mo ago), licensed MIT. It adds 3,526 tokens to every session, about $0.0176 per session on Opus 5. A static security scan graded it C with 1 finding (reaches for credential files). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.