Bridging Agno agents to Claude Code on the local machine — async escalation pattern

[abhinaykrupa]

Hey Agno community!

Building multi-agent systems that need to execute complex tasks on a real local machine (not a cloud sandbox)? Here's a bridge pattern that pairs naturally with Agno's architecture.

What it is

cowork-to-code-bridge — a local-first async bridge that lets Agno agents delegate to Claude Code on the user's Mac/Linux machine. Non-blocking, idempotent, with production safety built in.

from agno.agent import Agent
from agno.tools import tool
from cowork_to_code_bridge.client import queue_task, poll_task_result

@tool
def execute_on_local_machine(prompt: str) -> str:
    """Execute a complex coding task on the user's machine via Claude Code."""
    task_id = queue_task(prompt, idempotency_key=f"agno-{hash(prompt)}")
    
    while True:
        result = poll_task_result(task_id)
        if result["status"] == "completed":
            return result["output"]
        time.sleep(2)

agent = Agent(
    name="Local Executor",
    tools=[execute_on_local_machine],
    description="Executes complex coding tasks on the user's local machine"
)

Why this matters for multi-agent systems

Agno's strength is orchestrating multiple specialized agents. This bridge adds a "Local Executor" agent to your team that can:

• Run the actual test suite on the user's real project
• Push commits with the user's actual git identity
• Access local databases, Docker, environment variables
• Use installed CLI tools (webpack, cargo, etc.)

Production safety

• Per-operation metrics: api_spend_estimate, memory_mb, CPU
• Loop detection: circuit-breaker for runaway tool calls
• Budget caps: max_budget_usd per operation
• Graceful cancellation: SIGTERM + idempotent on completion
• No open ports: HMAC token auth, file-based transport

Repo: https://github.com/abhinaykrupa/cowork-to-code-bridge

Interested in how people here are handling local execution in multi-agent systems — especially the async handoff pattern between cloud orchestrator agents and local worker agents.