Part of The Agents and Actions ↗ — a family of open agent & automation projects.
GraphClaw logo GraphClaw
Open-source AI task orchestration

Work is a graph, not a list.

GraphClaw is a graph-based task orchestration system where an AI agent manages work for humans and other agents — with explicit dependencies, scored priorities, and an auditable lifecycle. Self-hosted and pluggable to the core.

Design Spec Build Review Tests Ship
Tasks, dependencies, and lifecycle state — modeled as one graph.
Why GraphClaw

An agent that reasons about the whole, not just the next item

Real work has dependencies, owners, delegation chains, and goal context. Modeling it as a property graph lets the agent prioritize, delegate, and explain — instead of just tracking.

Work is a graph

A property-graph model captures dependencies, blockers, owners, and goals — so the agent can reason about critical paths and bottlenecks.

7-factor scoring

Priorities come from timeline urgency, dependency weight, critical path, blockers, human overrides, and resource risk — and every score is explainable.

Agent-first orchestration

The agent breaks down work into subgraphs, delegates to humans and AI, follows up, batches outreach, and surfaces prioritized briefings.

Multi-channel

Reachable from Web chat, Email, WhatsApp, Telegram, Slack, and Teams. The agent is fully useful without ever opening a visual interface.

Real-time sync

SSE event streams and WebSocket chat keep every surface current. Whatever changes — in chat, cockpit, or API — reflects in the graph instantly.

Pluggable architecture

Database, gateway, LLM-provider, and infrastructure layers sit behind interfaces — swap Postgres+AGE, providers, channels, or storage without rewriting core logic.

How it works

One graph, three surfaces

The conversational agent is the primary interface. The visual cockpit and the admin panel are power-user complements — never gatekeepers.

1

Conversational channel

Daily briefings, quick decisions, task creation, and status updates over chat or email. Designed so you never need to open a UI.

Primary · daily
2

Visual graph cockpit

Review and edit graph structure, run planning sessions, decompose projects, and visualize dependencies. Add, edit, or override anything — it's your data.

Power use · weekly
3

Settings & admin

Configure channels, skills, MCP registry, LLM providers, scoring weights, guardrails, and SSO. The policy layer that everything else operates within.

Occasional
Explainable by default

“Why is this ranked here?” — always answerable

Prioritization is transparent, and every task moves through an auditable lifecycle.

7-factor priority score

Weighted contributions for a single task — surfaced, not hidden behind an advanced mode.

Timeline urgency.25
Dependency weight.20
Critical path.20
Blocker score.15
Human override.10
Resource risk.05
Constraint pressure.05

Auditable lifecycle

Tasks move through explicit states with recorded transitions and cascade logic.

Pending Active In progress Blocked Delayed Needs review Snoozed Complete Cancelled Inactive

Override scoring, lock nodes from agent modification, or edit any node and edge directly. The agent assists — it never gatekeeps.

Architecture

Pluggable to the core

Every external dependency sits behind an interface, so you can run GraphClaw your way.

Database layerPostgreSQL + Apache AGE (Cypher) + pgvector today; Neo4j / Neptune adapters tomorrow.
Gateway layerChannelAdapter interface — Email, WhatsApp, Telegram, Slack, Teams, and built-in Web chat.
LLM provider layerLLMClient interface — Anthropic, OpenAI, or 100+ models via LiteLLM, fully swappable.
Infrastructure layerStorage, message broker, and secrets behind ABCs — S3/MinIO, Redis/SQS, Secrets Manager/Vault.
Python 3.12 · FastAPI PostgreSQL · Apache AGE · pgvector React 19 · TypeScript Anthropic · OpenAI · LiteLLM shadcn/ui · Tailwind Docker · MinIO · Redis

Self-host first

GraphClaw runs as a self-hosted stack you control. Start with the backend and cockpit guides, or follow the public roadmap to see what's Now / Next / Later.