# Swarm 357

> https://swarm357.techtideai.io

Layered Claude agents, portable memory, honest cost controls.

## Documentation

- [Introduction](https://swarm357.techtideai.io/docs/getting-started/introduction): What Swarm 357 is, who it is for, and how the 357-role catalog works.
- [Quickstart](https://swarm357.techtideai.io/docs/getting-started/quickstart): Install techtide-swarm and run your first swarm task in five minutes.
- [Installation](https://swarm357.techtideai.io/docs/getting-started/installation): Install from PyPI, editable dev install, Docker, and optional Memvid bridge build.
- [Your first run](https://swarm357.techtideai.io/docs/getting-started/first-run): Boot the roster, execute a layer task, and inspect the checkpoint.
- [Core concepts](https://swarm357.techtideai.io/docs/getting-started/core-concepts): Layers, roles, souls, checkpoints, memory, and cost control fundamentals.
- [Architecture](https://swarm357.techtideai.io/docs/getting-started/architecture): How the Conductor, layers, memory, and observability fit together.
- [Running a task](https://swarm357.techtideai.io/docs/guides/running-a-task): Execute tasks via CLI and HTTP API with budgets and layer selection.
- [Layer routing](https://swarm357.techtideai.io/docs/guides/layer-routing): How the Conductor routes tasks to business layers.
- [Cost control and budgets](https://swarm357.techtideai.io/docs/guides/cost-control): Layer budgets, run caps, and model downgrade behavior.
- [Flat-file memory](https://swarm357.techtideai.io/docs/guides/flat-file-memory): Share and recall knowledge via .swarm/topics/.
- [Memvid bridge](https://swarm357.techtideai.io/docs/guides/memvid-bridge): Portable .mv2 memory via the Rust bridge binary.
- [Bash security gate](https://swarm357.techtideai.io/docs/guides/bash-security-gate): 13-pattern Bash validator and server-mode defaults.
- [Human-in-the-loop approvals](https://swarm357.techtideai.io/docs/guides/hitl-approvals): Approve or reject Bash commands before execution.
- [Checkpoints and resume](https://swarm357.techtideai.io/docs/guides/checkpoints-resume): Durable RunState in SQLite for inspect and resume.
- [Replay and fork](https://swarm357.techtideai.io/docs/guides/replay-fork): Re-run or branch from prior checkpoints.
- [Streaming events](https://swarm357.techtideai.io/docs/guides/streaming-events): SSE event types, auth, and stream.end semantics.
- [Telemetry and traces](https://swarm357.techtideai.io/docs/guides/telemetry-traces): JSONL telemetry, traces, and optional OpenTelemetry export.
- [UltraPlan](https://swarm357.techtideai.io/docs/guides/ultraplan): Deep Opus-class planning sessions.
- [Dream cycle](https://swarm357.techtideai.io/docs/guides/dream-cycle): Experimental memory consolidation heuristics.
- [CLI overview](https://swarm357.techtideai.io/docs/cli/overview): The swarm command-line interface entry point and global conventions.
- [init, demo, status](https://swarm357.techtideai.io/docs/cli/init-demo-status): Project setup, simulation demo, and health dashboard.
- [run, boot, agent](https://swarm357.techtideai.io/docs/cli/run-boot-agent): Execute tasks, boot the roster, and inspect individual agents.
- [inspect, resume, cancel](https://swarm357.techtideai.io/docs/cli/inspect-resume-cancel): Checkpoint inspection and run lifecycle control.
- [approve, reject](https://swarm357.techtideai.io/docs/cli/approve-reject): Resolve Bash HITL approval requests.
- [replay, fork](https://swarm357.techtideai.io/docs/cli/replay-fork): Replay prior runs or fork with an edited task.
- [dream, migrate, plan](https://swarm357.techtideai.io/docs/cli/dream-migrate-plan): Memory dream cycle, Memvid migration, and UltraPlan.
- [eval, serve](https://swarm357.techtideai.io/docs/cli/eval-serve): Run the eval harness and start the HTTP API server.
- [cost](https://swarm357.techtideai.io/docs/cli/cost): Show swarm cost report from CostController.
- [mcp](https://swarm357.techtideai.io/docs/cli/mcp): List and connect MCP servers from config/mcp/.
- [API overview](https://swarm357.techtideai.io/docs/api/overview): FastAPI HTTP surface for swarm orchestration.
- [Authentication](https://swarm357.techtideai.io/docs/api/authentication): X-SWARM-API-KEY header and production fail-closed behavior.
- [Errors and status codes](https://swarm357.techtideai.io/docs/api/errors): HTTP status code mapping for API errors.
- [Rate limits](https://swarm357.techtideai.io/docs/api/rate-limits): Per-IP sliding window rate limiting.
- [Health and status](https://swarm357.techtideai.io/docs/api/health-status): Health probe and swarm status endpoints.
- [Agents](https://swarm357.techtideai.io/docs/api/agents): List and inspect agent definitions.
- [Runs](https://swarm357.techtideai.io/docs/api/runs): List, inspect, resume, cancel, replay, and fork runs.
- [SSE event stream](https://swarm357.techtideai.io/docs/api/sse-events): Server-sent events for run progress.
- [Approvals and execution](https://swarm357.techtideai.io/docs/api/approvals-execution): HITL approvals and run execution endpoints.
- [SDK overview](https://swarm357.techtideai.io/docs/sdk/overview): Python package exports and installation.
- [Agent and AgentConfig](https://swarm357.techtideai.io/docs/sdk/agent): Single-agent runner configuration and results.
- [Swarm](https://swarm357.techtideai.io/docs/sdk/swarm): Full swarm orchestration from YAML config.
- [CostController](https://swarm357.techtideai.io/docs/sdk/cost-controller): Layer spend tracking and model downgrade.
- [MemoryManager](https://swarm357.techtideai.io/docs/sdk/memory-manager): Flat-file and Memvid memory operations.
- [MemvidBridge](https://swarm357.techtideai.io/docs/sdk/memvid-bridge): Rust bridge subprocess wrapper.
- [BashSecurityGate](https://swarm357.techtideai.io/docs/sdk/bash-security-gate): Bash command pattern validator.
- [ApprovalGate](https://swarm357.techtideai.io/docs/sdk/approval-gate): HITL approval workflow for Bash.
- [ToolRegistry](https://swarm357.techtideai.io/docs/sdk/tool-registry): Tool registration and Anthropic schema export.
- [UltraPlan](https://swarm357.techtideai.io/docs/sdk/ultraplan): Deep planning with Opus-class models.
- [Roster YAML](https://swarm357.techtideai.io/docs/configuration/roster-yaml): Compact roster format and layer role definitions.
- [Environment variables](https://swarm357.techtideai.io/docs/configuration/environment-variables): Complete environment variable reference for Swarm 357.
- [Model IDs and providers](https://swarm357.techtideai.io/docs/configuration/models): Anthropic direct and OpenRouter provider configuration.
- [MCP servers](https://swarm357.techtideai.io/docs/configuration/mcp-servers): Model Context Protocol server configuration.
- [Runtime files](https://swarm357.techtideai.io/docs/configuration/runtime-files): Files and directories under .swarm/ at runtime.
- [Roster overview](https://swarm357.techtideai.io/docs/roster/overview): The 357-agent catalog across seven business layers.
- [Management layer](https://swarm357.techtideai.io/docs/roster/management): 10 agents. Conductor, strategists, memory curator, QA, cost control
- [Sales layer](https://swarm357.techtideai.io/docs/roster/sales): 62 agents. CRM, outreach, SDR, funnel analysis, deal closing
- [Support layer](https://swarm357.techtideai.io/docs/roster/support): 55 agents. Tier 1/2 resolution, KB, escalation, CSAT
- [Marketing layer](https://swarm357.techtideai.io/docs/roster/marketing): 68 agents. Content, social, ads, email, brand, campaigns
- [SEO layer](https://swarm357.techtideai.io/docs/roster/seo): 47 agents. Keywords, technical SEO, link building, AEO
- [Research layer](https://swarm357.techtideai.io/docs/roster/research): 58 agents. Market, competitor, product research, synthesis
- [Operations layer](https://swarm357.techtideai.io/docs/roster/operations): 57 agents. Projects, finance, infra, automation, data quality
- [Docker](https://swarm357.techtideai.io/docs/deployment/docker): Container build and run for the API server.
- [Railway](https://swarm357.techtideai.io/docs/deployment/railway): Deploy Swarm 357 API and landing on Railway.
- [Supabase data plane](https://swarm357.techtideai.io/docs/deployment/supabase): Optional Supabase persistence layer.
- [Production checklist](https://swarm357.techtideai.io/docs/deployment/production-checklist): Pre-launch verification for production deployments.
- [Security model](https://swarm357.techtideai.io/docs/security/security-model): Supported versions, reporting, and posture summary.
- [Bash policy](https://swarm357.techtideai.io/docs/security/bash-policy): BashSecurityGate patterns and server defaults.
- [Filesystem confinement](https://swarm357.techtideai.io/docs/security/filesystem): Read/Write workspace root restrictions.
- [Authentication](https://swarm357.techtideai.io/docs/security/authentication): Shared-secret API key authentication model.
- [Enterprise controls](https://swarm357.techtideai.io/docs/security/enterprise-controls): Enterprise security and governance mapping.
- [Eval methodology](https://swarm357.techtideai.io/docs/evals/methodology): Keyword, length, LLM judge, and budget gates.
- [Task catalog](https://swarm357.techtideai.io/docs/evals/task-catalog): 25 eval tasks across layers and modes.
- [Latest baseline](https://swarm357.techtideai.io/docs/evals/latest-baseline): Current eval baseline metrics from latest.json.
- [Reproducing evals](https://swarm357.techtideai.io/docs/evals/reproducing): Commands to run and compare eval baselines.
- [Status and maturity](https://swarm357.techtideai.io/docs/resources/status): Feature maturity matrix for Swarm 357.
- [Verification scorecard](https://swarm357.techtideai.io/docs/resources/verification): Executable acceptance criteria for releases.
- [Comparison](https://swarm357.techtideai.io/docs/resources/comparison): How Swarm 357 compares to other frameworks.
- [Roadmap](https://swarm357.techtideai.io/docs/resources/roadmap): Planned features and backlog.
- [Contributing](https://swarm357.techtideai.io/docs/resources/contributing): Development setup and contribution guidelines.
- [Release process](https://swarm357.techtideai.io/docs/resources/release): Versioning, tagging, and PyPI publish workflow.
- [Design system](https://swarm357.techtideai.io/docs/resources/design): Tokens, class tiers, interaction rules, and content standards for the Swarm 357 product surface.
- [Glossary](https://swarm357.techtideai.io/docs/resources/glossary): Key terms used across Swarm 357 documentation.
- [FAQ](https://swarm357.techtideai.io/docs/resources/faq): Frequently asked questions about Swarm 357.
- [seo aeo optimizer](https://swarm357.techtideai.io/docs/roster/roles/aeo-optimizer): seo role: seo aeo optimizer
- [management cost controller](https://swarm357.techtideai.io/docs/roster/roles/cost-controller): management role: management cost controller
- [sales outreach specialist](https://swarm357.techtideai.io/docs/roster/roles/outreach-specialist): sales role: sales outreach specialist
- [management routing optimizer](https://swarm357.techtideai.io/docs/roster/roles/routing-optimizer): management role: management routing optimizer
- [management qa auditor](https://swarm357.techtideai.io/docs/roster/roles/qa-auditor): management role: management qa auditor
- [support tier2 resolver](https://swarm357.techtideai.io/docs/roster/roles/tier2-resolver): support role: support tier2 resolver
- [management chief strategist](https://swarm357.techtideai.io/docs/roster/roles/chief-strategist): management role: management chief strategist
- [marketing content strategist](https://swarm357.techtideai.io/docs/roster/roles/content-strategist): marketing role: marketing content strategist
- [marketing campaign analyst](https://swarm357.techtideai.io/docs/roster/roles/campaign-analyst): marketing role: marketing campaign analyst
- [research product researcher](https://swarm357.techtideai.io/docs/roster/roles/product-researcher): research role: research product researcher
- [support escalation handler](https://swarm357.techtideai.io/docs/roster/roles/escalation-handler): support role: support escalation handler
- [management memory curator](https://swarm357.techtideai.io/docs/roster/roles/memory-curator): management role: management memory curator
- [support csat analyst](https://swarm357.techtideai.io/docs/roster/roles/csat-analyst): support role: support csat analyst
- [sales prospect researcher](https://swarm357.techtideai.io/docs/roster/roles/prospect-researcher): sales role: sales prospect researcher
- [support tier1 resolver](https://swarm357.techtideai.io/docs/roster/roles/tier1-resolver): support role: support tier1 resolver
- [support kb maintainer](https://swarm357.techtideai.io/docs/roster/roles/kb-maintainer): support role: support kb maintainer
- [marketing brand guardian](https://swarm357.techtideai.io/docs/roster/roles/brand-guardian): marketing role: marketing brand guardian
- [operations finance reporter](https://swarm357.techtideai.io/docs/roster/roles/finance-reporter): operations role: operations finance reporter
- [management conductor](https://swarm357.techtideai.io/docs/roster/roles/conductor): management role: management conductor
- [management dream runner](https://swarm357.techtideai.io/docs/roster/roles/dream-runner): management role: management dream runner
- [seo link building specialist](https://swarm357.techtideai.io/docs/roster/roles/link-building-specialist): seo role: seo link building specialist
- [operations data quality agent](https://swarm357.techtideai.io/docs/roster/roles/data-quality-agent): operations role: operations data quality agent
- [research market analyst](https://swarm357.techtideai.io/docs/roster/roles/market-analyst): research role: research market analyst
- [management health monitor](https://swarm357.techtideai.io/docs/roster/roles/health-monitor): management role: management health monitor
- [seo technical seo auditor](https://swarm357.techtideai.io/docs/roster/roles/technical-seo-auditor): seo role: seo technical seo auditor
- [management pattern promoter](https://swarm357.techtideai.io/docs/roster/roles/pattern-promoter): management role: management pattern promoter
- [sales crm operator](https://swarm357.techtideai.io/docs/roster/roles/crm-operator): sales role: sales crm operator
- [research competitor analyst](https://swarm357.techtideai.io/docs/roster/roles/competitor-analyst): research role: research competitor analyst
- [sales deal closer](https://swarm357.techtideai.io/docs/roster/roles/deal-closer): sales role: sales deal closer
- [management skill extractor](https://swarm357.techtideai.io/docs/roster/roles/skill-extractor): management role: management skill extractor
- [sales sdr](https://swarm357.techtideai.io/docs/roster/roles/sdr): sales role: sales sdr
- [research research synthesizer](https://swarm357.techtideai.io/docs/roster/roles/research-synthesizer): research role: research research synthesizer
- [marketing email campaign manager](https://swarm357.techtideai.io/docs/roster/roles/email-campaign-manager): marketing role: marketing email campaign manager
- [marketing ad copywriter](https://swarm357.techtideai.io/docs/roster/roles/ad-copywriter): marketing role: marketing ad copywriter
- [marketing social media manager](https://swarm357.techtideai.io/docs/roster/roles/social-media-manager): marketing role: marketing social media manager
- [operations infra agent](https://swarm357.techtideai.io/docs/roster/roles/infra-agent): operations role: operations infra agent
- [seo keyword researcher](https://swarm357.techtideai.io/docs/roster/roles/keyword-researcher): seo role: seo keyword researcher
- [sales funnel analyst](https://swarm357.techtideai.io/docs/roster/roles/funnel-analyst): sales role: sales funnel analyst
- [operations project coordinator](https://swarm357.techtideai.io/docs/roster/roles/project-coordinator): operations role: operations project coordinator
- [research trend watcher](https://swarm357.techtideai.io/docs/roster/roles/trend-watcher): research role: research trend watcher
- [operations automation builder](https://swarm357.techtideai.io/docs/roster/roles/automation-builder): operations role: operations automation builder

## Blog

- [Swarm 357 mid-year status: what is Stable, Beta, and not built](https://swarm357.techtideai.io/blog/swarm-357-mid-year-status): The July 2026 maturity picture in plain language. What hardened this year, what is still Beta and why, and the four things that are explicitly not implemented.
- [Scenario: a support layer where Bash stays denied](https://swarm357.techtideai.io/blog/scenario-support-bash-denied-until-hitl): Triage, macro drafting, and escalation summaries with no shell access at all. What the support layer does without it, and when a human unlocks a command.
- [Building a 357 role catalog for AI agents](https://swarm357.techtideai.io/blog/building-a-357-role-catalog): How six business layers and 357 roles were drawn, what a soul template holds, and the three mistakes that make a role catalog useless.
- [A FastAPI agent API with SSE, fail-closed auth, and redacted reads](https://swarm357.techtideai.io/blog/fastapi-swarm-api-sse-auth): Streaming agent events over server-sent events, authenticating writes without breaking the stream, and publishing telemetry without leaking task content.
- [Scenario: a sales layer that stops at the CRM handoff](https://swarm357.techtideai.io/blog/scenario-sales-layer-crm-handoff): A worked scenario for research, drafting, and handoff notes, with the send left to a human. What the sales layer refuses to do, and why that line matters.
- [Durable checkpoints: resume, cancel, replay, and fork](https://swarm357.techtideai.io/blog/durable-checkpoints-resume-cancel-replay): A run that dies at step nine should not restart at step one. How SQLite-backed state turns a crash into a resume, and why cancel must be a persisted flag.
- [OpenRouter and cheap models for swarm tests](https://swarm357.techtideai.io/blog/openrouter-cheap-models-for-swarm-tests): Point the runtime at OpenRouter, use a cheap tool-capable model to iterate, and keep premium models for baselines. Why free models break tool calling.
- [Four token budgeting patterns for multi-agent systems](https://swarm357.techtideai.io/blog/multi-agent-token-budgeting-patterns): Reserve before the call, budget by layer not by run, degrade loudly, and cap the context you load. Patterns that keep parallel agents inside your number.
- [LangGraph and role catalog runtimes solve different problems](https://swarm357.techtideai.io/blog/langgraph-vs-role-catalog-runtimes): A state graph gives you explicit control flow. A role catalog gives you governed workers. When you need one, when you need both, and how to tell.
- [What an agent swarm actually means in production](https://swarm357.techtideai.io/blog/what-agent-swarm-means-in-production): The word swarm gets used for three different systems. A definition that survives a security review, plus the four vendor claims that do not hold up.
- [Deploying a Claude agent runtime on Railway](https://swarm357.techtideai.io/blog/deploying-claude-agent-runtime-railway): Split the API from the landing site, keep write keys server-only, force simulate on the public demo, and let the container make Bash fail closed.
- [How to actually evaluate an agent swarm](https://swarm357.techtideai.io/blog/how-to-evaluate-an-agent-swarm): Single-agent and swarm metrics measure different systems. An eval methodology with budget caps, baselines in version control, and the numbers that lie.
- [CrewAI, AutoGen, and role ontologies](https://swarm357.techtideai.io/blog/crewai-autogen-vs-role-ontology): Ad-hoc crews, conversation graphs, and pre-declared role catalogs solve different problems. A criteria table, and when a catalog is the wrong answer.
- [Human-in-the-loop approvals for autonomous agents](https://swarm357.techtideai.io/blog/human-in-the-loop-approvals-for-agents): A durable ApprovalRecord, a control plane on both CLI and HTTP, and timeouts that reject. Putting a person in front of side effects without stalling runs.
- [Why your agent needs a bash policy gate](https://swarm357.techtideai.io/blog/why-your-agent-needs-a-bash-policy-gate): Thirteen patterns, argv-level validation, and a deny-by-default posture in production. What a bash policy gate stops, and the three things it will never stop.
- [Portable agent memory with Memvid](https://swarm357.techtideai.io/blog/portable-agent-memory-with-memvid): Flat-file topics for memory you read, a single-file .mv2 archive for memory you search. How the Memvid bridge gives agents recall you can copy and diff.
- [Cost control for LLM agent fleets](https://swarm357.techtideai.io/blog/cost-control-for-llm-agent-fleets): Layer budgets, an atomic ledger, and a logged downgrade at 80 percent. The FinOps primitives that keep a multi-agent run from becoming a surprise invoice.
- [pip install techtide-swarm: your first run, start to finish](https://swarm357.techtideai.io/blog/pip-install-techtide-swarm-first-run): Install the package, run the simulated demo with no API key, then make one live call on a cheap model. With the four errors people actually hit.
- [Multi-agent orchestration without the headcount fantasy](https://swarm357.techtideai.io/blog/multi-agent-orchestration-without-headcount-fantasy): 357 roles is an org chart for agents, not 357 models at once. How role catalogs, layer routing, and hard agent caps keep a multi-agent system solvent.

## Blog topics

- [Architecture](https://swarm357.techtideai.io/blog/tag/architecture): 11 articles on architecture.
- [Operations](https://swarm357.techtideai.io/blog/tag/operations): 10 articles on operations.
- [Cost control](https://swarm357.techtideai.io/blog/tag/cost-control): 5 articles on cost control.
- [Security](https://swarm357.techtideai.io/blog/tag/security): 5 articles on security.
- [Orchestration](https://swarm357.techtideai.io/blog/tag/orchestration): 4 articles on orchestration.
- [Comparison](https://swarm357.techtideai.io/blog/tag/comparison): 2 articles on comparison.
- [FinOps](https://swarm357.techtideai.io/blog/tag/finops): 2 articles on finops.
- [Scenarios](https://swarm357.techtideai.io/blog/tag/scenarios): 2 articles on scenarios.

## Pages

- [About](https://swarm357.techtideai.io/about): who builds Swarm 357 and why.
- [Status](https://swarm357.techtideai.io/docs/resources/status): maturity matrix for every subsystem.
- [Security](https://swarm357.techtideai.io/docs/security/security-model): auth, HITL, filesystem, and model honesty.
- [Evals](https://swarm357.techtideai.io/evals): baseline driven metrics.
- [Changelog](https://swarm357.techtideai.io/changelog): release history.

## Optional

- Full text bundle: https://swarm357.techtideai.io/llms-full.txt
- Blog feed: https://swarm357.techtideai.io/feed.xml