🚜 Farm Table

Farm Table is an open-source task runtime built specifically for AI agents. It provides coding and execution agents with a single, predictable, and robust interface to receive work, understand complex dependency structures, and track execution progress—whether tasks reside in GitHub, Jira, Linear, or Farm Table's own built-in graph-native backend.

When no external platform is connected, the built-in backend provides a graph-native task store complete with dependency tracking, atomic CAS (Compare-And-Swap) claims, and instant ready-task detection. No API keys, no SaaS accounts, and zero complex configuration are required.

NOTE: Farmtable is at an early and experimental stage

🚀 System Architecture & Modes

Farm Table operates transparently in two modes from the exact same codebase:

┌─ Embedded Mode (Default) ──────────────────────────────────────┐
│  ft CLI ──bufconn──► In-Process FarmTableService               │
│                      └──► EntStore (SQLite)                    │
│  Single process. Zero infrastructure. Just works.              │
├─ Client-Server Mode ───────────────────────────────────────────┤
│  ft CLI ──gRPC/TLS──► farmtable-server (Separate Process)      │
│                       └──► EntStore (Postgres)                 │
│  Multi-agent coordination. Production deployments.             │
└────────────────────────────────────────────────────────────────┘

• Embedded Mode: Automatically selected by default. SQLite is used as the local store at ~/.farmtable/farmtable.db (overridable via FARMTABLE_DB_PATH). Communication is routed through bufconn (an in-memory network connection), creating a single-binary zero-dependency experience.
• Client-Server Mode: Enabled automatically if the FARMTABLE_SERVER environment variable, --server flag, or the config file server key is supplied. This connects the CLI or agent to a standalone farmtable-server backed by Postgres for multi-agent coordination.

💎 Core Abstractions & Features

📦 Normalized Task Object (NTO)

Every task—whether synced from GitHub or managed locally—is represented in a single, predictable schema defined in Protobuf (proto/farmtable/v1/farmtable.proto).

• Task State Model: Native tasks use asserted stages such as triage, accepted, working, h