Back to Home
rawe icon

claude-agent-orchestrator

by rawe

Overview

The Agent Runner facilitates a distributed agent orchestration framework by polling an Agent Coordinator for AI and procedural agent execution tasks, managing their lifecycle, and providing an embedded MCP server for child agent communication.

Installation

Run Command
./servers/agent-runner/agent-runner

Environment Variables

  • AGENT_ORCHESTRATOR_API_URL
  • PROJECT_DIR
  • AUTH0_DOMAIN
  • AUTH0_RUNNER_CLIENT_ID
  • AUTH0_RUNNER_CLIENT_SECRET
  • AUTH0_AUDIENCE
  • CLAUDE_CODE_OAUTH_TOKEN

Security Notes

The system utilizes Auth0 M2M for authentication with the Coordinator, requiring sensitive credentials (client_secret) to be securely managed via environment variables. The embedded MCP server and Runner Gateway are bound to localhost by default, which is good for restricting network exposure. However, the 'claude-code' executor profile often uses 'bypassPermissions' mode, allowing AI agents extensive system access within their `project_dir` without user prompts. This is a significant privilege and a potential risk if agents or prompts are untrusted, making security highly dependent on the integrity of the agents themselves. Placeholder resolution and environment variable injection into MCP configurations (e.g., in `claude_client.py`) could also be vectors if the runner's environment is compromised.

Similar Servers

Stats

Interest Score30
Security Score7
Cost ClassHigh
Avg Tokens75000
Stars1
Forks0
Last Update2026-01-19

Tags

Agent OrchestrationAI AgentsTask ExecutionDistributed SystemsPython