How-to guides

Steps for a goal you already have.

• Register the MCP server manually

  Add nexus-agents as an MCP server to Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI or OpenCode without running setup.

  • How-to guide
  • For users

• Add nexus-agents review gates to your CI

  Fail a GitHub Actions job when a nexus-agents voter panel does not approve a pull request diff.

  • How-to guide
  • For users

• Claude Code plugin install

  Install nexus-agents as a Claude Code plugin — exposes 47 MCP tools, 33 skills, 12 agent mirrors, and governance hooks

  • How-to guide
  • For users

• Cloud provider setup (Bedrock, Vertex, Azure)

  Three paths to route nexus-agents through Bedrock, Vertex AI, Azure OpenAI, and any other cloud-hosted model — without nexus-agents shipping provider-specific code

  • How-to guide
  • For users

• Corporate OpenAI-spec gateway

  Run nexus-agents as an MCP server behind one OpenAI-compatible gateway that serves Anthropic, OpenAI and Google models, with no local CLIs

  • How-to guide
  • For users

• Custom OpenAI-compatible endpoint setup

  Configure nexus-agents to use an OpenAI-compatible gateway directly or through OpenCode

  • How-to guide
  • For users

• Debugging with observability

  Debug multi-agent workflows using EventBus, correlation IDs, and OrchestrationObserver (formerly SwarmObserver)

  • How-to guide
  • For users

• Harness compatibility guide

  Wire nexus-agents as an MCP peer from OpenCode, Codex CLI, Cursor, Aider, and Cline

  • How-to guide
  • For users

• Installation guide

  Detailed installation instructions for nexus-agents across all platforms, Docker, and CI/CD environments

  • How-to guide
  • For users

• MCP & Claude Desktop integration

  MCP tools for orchestration, experts, workflows, consensus, research, memory, and tracing

  • How-to guide
  • For users

• Migrate acceptance-bound pipeline resumes

  Recover from a checkpoint evidence block and manage retained pipeline context.

  • How-to guide
  • For users

• Sandboxed usage

  Run nexus-agents inside Docker, restricted-FS sandboxes, and team-distribution flows; OpenCode-in-Docker + OpenAI-compat gateway scenario.

  • How-to guide
  • For users

• Scratch filesystem exhaustion runbook

  Symptom, diagnostic, and recovery for a full /tmp during a long autonomous run — every subprocess fails after doing its work, so the output is lost rather than the command refused.

  • How-to guide
  • For users

• Troubleshooting guide

  Common issues, error resolution, and FAQ for nexus-agents

  • How-to guide
  • For users

• Workflow templates

  Create and customize YAML workflow templates for multi-agent task execution

  • How-to guide
  • For users