Skip to main content

alphaswarm-assistant

Catalog date: 2026-06-24.

alphaswarm-assistant is the versioned customization layer and per-tenant seeder for the agentic assistant (Cline) shipped inside the AlphaSwarm IDE.

Role​

  • Tenant Seeding: Renders an AlphaSwarm-correct, tenant-isolated Cline configuration into each user's IDE pod at startup.
  • Provider Configuration: Configures AWS Bedrock (primary) and gateway fallbacks without requiring BYOK onboarding.
  • Rules Bank: Injects the .clinerules/ bank (governance, architecture, hard rules) into the user's workspace.
  • MCP Integration: Wires the AlphaSwarm MCP surfaces (platform, codebase, data, docs) into the assistant's toolset.

Architecture​

The seeder runs as part of the IDE container entrypoint. It resolves tenant identity from the environment and writes the necessary JSON and Markdown configuration files to the user's persistent volume before launching the IDE.

Hard Boundaries​

  1. No alphaswarm.* Imports: Decoupled from the monolith; uses HTTP/env and alphaswarm_core primitives.
  2. No Secrets in Repo: Bedrock access via IAM roles (IRSA); tokens injected at runtime.
  3. Tenancy Headers: Enforces tenancy headers on all MCP requests (rule 51).

Repository​