Switchyard documentation
Task-oriented guides for the local development command center.
Start here
- Choose an installation for macOS, Windows, Linux, WSL2, or headless use.
- Add your first project through deterministic discovery and explicit trust.
- Run a Compose project or a native-process project.
- Follow logs and health and resolve a port conflict.
- Coordinate a workspace.
Operate and integrate
- Projects and manifests: onboarding concepts and manifest reference
- Runtime: Docker Compose, native processes, and terminal sessions
- Evidence: logs, health, and resources and support bundles
- Agents: Codex guide, Claude Code guide, and MCP reference
- Automation: CLI contract and plugin SDK
Troubleshoot and contribute
Start with troubleshooting by symptom. It separates safe evidence from sensitive source, environment, or diagnostic data.
Contributors should read the architecture overview, engineering conventions, and adapter development guide before changing a domain or platform boundary.
Use this pageLast verified Jul 17, 2026
Copy-ready MarkdownOpen sourceReport a docs issue