Skip to content

Shell

Shell is the callable half of AAAX. After a package or strategy is loaded and resources are mounted, AAAX exposes the same strategy through surfaces for humans, applications, coding agents, and other systems.

flowchart LR A["Strategy"] --> B["Mounted resources"] B --> C["CLI shell"] B --> D["FastAPI shell"] B --> E["Agentic shell"] C --> F["human inspect and serve"] D --> G["apps and services"] E --> H["agents or next systems"]

Shell Surfaces

  • CLI Shell: a human-facing command surface for inspecting, mounting, and serving packages.
  • FastAPI Shell: an application-facing HTTP surface for /run, tactics, channels, packages, resource invocation, and other systems that need to connect.
  • Agentic Shell: an agent-facing context surface for Codex, Claude Code, IDE agents, and other coding-agent workflows.

Operational Boundary

AAAX validates host, port, and log-level CLI inputs. It does not manage TLS, replicas, queue workers, secrets, containers, or cloud deployment. Keep those in the deployment layer and treat AAAX as the shell object that layer serves.