Open Source · Apache 2.0

Your AI needs a team, not a prompt.

Deploy agents that wake on schedule, message each other, share knowledge, and run 24/7. No babysitting. Any LLM.

View on GitHub
FlockRun Live
CEO
Security
Research
Ops Lead
Editor
Security Alert
Content Pipeline
Research Intel
Works with
Anthropic OpenAI Google Ollama OpenRouter + 20 more
2,708+ tests passing TypeScript Open Source 6 templates 6 adapters GitHub
01 The Problem

The problem isn't intelligence.
It's coordination.

Your AI can write code, answer questions, analyze data. But can two agents hand off a task? Can five agents share context without drowning each other? Can a team run overnight and pick up where it left off? That's the hard part.

Strings passed agent-to-agent in a fixed order. No branching, no pub/sub, no way for agents to decide who to talk to next. One agent fails and the whole chain breaks.

Every agent sees everything. No scoped access, no private channels, no way to isolate teams or control information flow. Context windows explode.

Rigid graph routing. Agents can't autonomously escalate, broadcast, or subscribe to topics they care about. Every path must be pre-defined by a human.

File tickets and wait. No real-time wake, no broadcast channels, no shared knowledge base across the team. Minutes become hours.

02 How It Works

From zero to coordinating agents.

01

Start your first agent

One command. A head agent comes online as your coordinator. Connect any LLM. Dashboard ready at localhost:3000.

02

Add branches as you grow

Deploy specialized branches: Content, Research, DevOps. Pick from 6 templates or create your own. Each gets its own manager and schedule.

03

They coordinate autonomously

Agents message each other, share knowledge, route tasks across branches, and escalate. Watch it all happen live from the dashboard.

03 What's Built In

Everything agents need to work as a team.

0 data sources

Smart Context Briefings

Every invocation assembles a structured briefing from 22 sources: tasks, messages, knowledge, metrics, cross-branch state. Priority-truncated to fit the token budget. Agents always know what matters.

0 action types

Structured Messaging

Direct messages, broadcasts, cross-branch routing, escalation chains, pub/sub topics. Real communication protocols, not strings passed in a fixed order.

24/7 always-on

Always-On Scheduling

Cron schedules with per-invocation jitter. Event-driven wake when agents message each other. They work overnight, over weekends, while you're offline. No polling, no heartbeat delays.

BFS depth 50

Self-Healing Pipelines

Cross-branch task routing with automatic cycle detection. Agent A tasks B, B tasks C, C tasks A? Caught and resolved. No frozen pipelines, no manual intervention.

3 scope levels

Shared Knowledge

Private agent notes, branch-wide team knowledge, global company knowledge. Auto-expiring entries, tag search, scoped access. Agents build on each other's work.

0 cloud deps

Fully Self-Hosted

SQLite + Node.js. No cloud lock-in, no Docker, no Kubernetes. Your data stays on your machine. Add Redis when you need queue scaling.

04 Dashboard

See your agents in action.

17 pages. Real-time WebSocket updates. Agent tree, activity timeline, task routing, knowledge base.

FlockRun Dashboard 6 agents online
Agent Tree
CEO
├ Security Lead
├ Research Dir.
├ Content Editor
├ DevOps Lead
└ Social Manager
28messages
12knowledge
4tasks
Activity Timeline
12:04 CEO Security Lead task
"Audit the latest PR for OWASP top 10 vulnerabilities"
12:06 Security Lead CEO alert
"2 critical: XSS in /api/search, SQL injection in /api/users"
12:07 CEO DevOps escalation
"Hold deployment pipeline. Security fixes required."
12:09 Research knowledge write
"CVE-2026-3891 patch: upgrade express to 4.19.2"
12:11 DevOps CEO done
"Deployed with fix applied. All checks green."
Agent Activity 24h
Token Usage by branch
172k
Security Research Content DevOps
Task Completion this week
Security
6/7
DevOps
4/4
Research
2/3
Content
1/2
05 Templates

Specialized branches. Ready to deploy.

Content Production

Content calendar, AI-assisted drafting, multi-platform distribution, performance tracking.

content-production

Social Media Growth

Campaign management, content scheduling, engagement analytics, audience growth.

social-media-growth

Deal Flow & Sales

Lead discovery, company enrichment, personalized outreach, pipeline management.

deal-flow

Research & Intelligence

Multi-source monitoring, trend synthesis, competitive analysis, intelligence briefings.

research-intelligence

OSS Management

Issue triage, PR review, community engagement, release coordination, onboarding.

oss-management

DevOps & Incident Response

Health checks, automated incident response, deployment management, post-mortems.

devops-incident-response

Security & Code Review

OWASP top 10, dependency CVE monitoring, automated pentesting, posture reports.

security-code-review

Head Agent (CEO)

Coordinates all branches, routes cross-branch tasks, monitors health, onboards teams.

head-agent
included by default
06 Adapters

Works with your AI.

Six adapters shipped. Mix providers per agent. CEO on Claude, workers on Ollama.

Registered Adapters 6 active
Anthropic
Claude models OAuth PKCE
OpenAI
GPT models OAuth PKCE
Ollama
Local models
Claude Code
CLI adapter
OpenClaw
Gateway
HTTP
Any OpenAI-compatible API
07 Quickstart

Running in 60 seconds.

terminal
~
~
~

Zero external dependencies. SQLite built-in. No Redis, no Docker, no Kubernetes. Just Node.js.

Start building.

Open source. Self-hosted. Your agents, your data, your rules.

View on GitHub