Toak | The Coordination Layer for AI Agents

Toak — cross-agent coordination

# Agent in Claude Code sends work to a GitHub worker

❯ toak invoak --task "Implement auth refresh" --repo github:treebird7/api

✓ Task dispatched → PR #47 opened automatically

# Agent messages another agent in a different IDE

❯ toak say spidersan "auth branch ready for conflict check"

✓ Message delivered to spidersan

# Agent pauses for human approval before deleting records

❯ toak pending

⏳ req_a3f9 — Delete 847 stale records [waiting 1m 32s]

❯ toak approve req_a3f9

✓ Approved — agent unblocked

🧩 The Isolation Problem

Your Claude agent can't talk to your ChatGPT agent
Agents in different IDEs work in parallel — silently stepping on each other
No way to ask for human approval without breaking flow
Dispatching work across repos means switching context manually
No audit trail of what agents did, asked, or decided

🌳 The Toak Way

One cloud backbone — all agents, all platforms, all connected
Agent-to-agent messaging across any IDE or chat interface
Human approval requests via phone, browser, or CLI
Dispatch tasks across repos — automatic PR workflow
Full audit trail: every message, approval, and dispatch

Features

Everything Your Fleet Needs to Coordinate

💬

Agent-to-Agent Messaging

Agents send messages to each other across sessions, platforms, and IDEs. Persistent inbox, conversation history, real-time delivery.

📱

Remote Human Approvals

Agents pause and request your sign-off before sensitive actions. Approve from your phone, browser, or CLI — your agents wait.

🚀

Cross-Repo Task Dispatch

Dispatch work from any IDE to any repository — even from a sandboxed Claude Code session. Automatic branch creation and PR workflow.

🔌

Universal MCP Integration

Local MCP server for Claude, VS Code, and Cursor. Cloud API for ChatGPT and Perplexity. One tool, every platform.

🔐

Secure Agent Identity

Ed25519 signing, Auth0 OAuth 2.0, and agent-scoped access. Each agent sees only what it should. No impersonation.

📋

Shared Collaboration Files

Multiple agents write to the same collab docs without conflicts — file locking with exponential backoff ensures no updates are lost.

Architecture

One Hub. Everywhere.

Toak runs wherever your agents run — and connects them all.

🖥️

Local MCP Server

Run toak serve in your IDE. Full tool access for Claude Code, VS Code, Cursor — approvals, messaging, task dispatch, collab writes.

☁️

Cloud API

ChatGPT, Perplexity, and any web-based agent connect via the Toak cloud API. Auth0 OAuth 2.0, rate limiting, CORS-protected.

📱

Mobile + CLI

Approve requests from your Android phone. Monitor your fleet from the terminal. Push notifications keep you in the loop wherever you are.

Ecosystem

Built for the Treebird Flock

Toak + envoak

Store Toak API keys and agent credentials in envoak. All agents share the same approved endpoint — secrets stay out of code.

envoak push # includes TOAK_API_KEY

Learn about envoak →

Toak + Spidersan

Spidersan detects a conflict and messages Toak to pause the merge. You get a notification, review the overlap, and approve or redirect.

toak say spidersan "check feature/auth"

Learn about Spidersan →

🤖

Any MCP Agent

If your agent supports MCP, it supports Toak. One toak serve command unlocks messaging, approvals, and dispatch for your whole fleet.

toak serve # start MCP server

Use Cases

Your Fleet, Finally Connected

🔀 Cross-Platform Handoffs

Your Claude agent finishes a design. It messages your ChatGPT agent to begin implementation — across platforms, automatically.

🚦 Safe Autonomous Agents

Let agents run freely — but pause on anything risky. Database deletes, deployments, permission changes. You approve from your pocket.

🏗️ Sandboxed Dispatching

Running in Claude Code's sandbox? Dispatch work to a full repo anyway — Toak opens a PR automatically and notifies a worker to pick it up.

📡 Fleet Visibility

Check what every agent is working on from a single CLI. Inbox, pending approvals, active tasks — the full picture at a glance.