docs/agent-mux/tutorials
Agent Mux Tutorials guide
Use these guides when you want to accomplish a concrete @a5c-ai/agent-mux task and do not need the full normative reference first.
Pages in this section
Start with the section hub, then move sideways into adjacent pages when you need more detail.
Cost tracking
Pageagent-mux emits a cost event whenever an adapter reports usage. You can
wiki/docs/agent-mux/tutorials/cost-tracking.md
RunOptions.invocationMode = { kind: 'docker', ... } runs the agent inside a Docker container. The adapter builds the CLI args as usual; the invocation mode wraps them with docker run.
wiki/docs/agent-mux/tutorials/docker-mode.md
Getting Started
PageThis walkthrough installs @a5c-ai/agent-mux, verifies your environment, and runs your first agent.
wiki/docs/agent-mux/tutorials/getting-started.md
Hooks
PageHooks let you observe and intercept agent activity at well-defined points without modifying the adapter.
wiki/docs/agent-mux/tutorials/hooks.md
RunOptions.invocationMode = { kind: 'k8s', ... } runs the agent inside a Kubernetes pod, exec'ing into a container you control.
wiki/docs/agent-mux/tutorials/k8s-mode.md
Mock Harness
PageThe mock harness replaces the real CLI spawn with a scripted event stream. Use it for tests, CI, and demos where real credentials or network access are undesirable.
wiki/docs/agent-mux/tutorials/mock-harness.md
agent-mux lets you fan out a prompt to multiple adapters and merge the result stream. This is useful for voting, consensus, or comparison.
wiki/docs/agent-mux/tutorials/multi-agent.md
Plugins (MCP)
Pageagent-mux normalizes plugin management across adapters that support the Model Context Protocol. Under the hood it writes to each agent's MCP config file.
wiki/docs/agent-mux/tutorials/plugins.md
Remote bootstrap
PageThe agent-mux-remote adapter lets you drive a coding agent that runs on a
wiki/docs/agent-mux/tutorials/remote-bootstrap.md
Sessions
PageAgent-mux persists every run as a session: a JSONL file written by the
wiki/docs/agent-mux/tutorials/sessions.md
Agent Mux Tutorials
Use these guides when you want to accomplish a concrete @a5c-ai/agent-mux task and do not need the full normative reference first.
Audience
- Package users learning the common workflows
- Integrators validating sessions, hooks, plugins, or remote execution modes
- Contributors writing examples that must stay clearly non-normative
Usage Rule
Tutorials explain workflows. They do not override the canonical contract in Agent Mux Reference.
Suggested Path
1. Getting Started 2. Sessions 3. Hooks 4. Plugins 5. Pick an environment-specific guide such as Docker, Kubernetes, mock harness, or remote bootstrap.