Skip to content

figs-so/app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Figs — app

The Figs app: a read-only window into the AI agents a company runs as back-office employees — an org chart of your AI workforce, a glance view per agent, and an inbox of the handoffs an agent needs a human to resolve. Agents push their state; this app mirrors and displays it.

This repo is the hosted app (the UI). For the open protocol and the CLI agents use to publish — the .figs format and figs push — see figs-so/figs (MIT). This app is AGPL-3.0.

How it fits together

your agent (Claude Code / Codex / Cursor)
   └─ writes .figs/  ──figs push──▶  this app  ──▶  humans read the org chart + handoff inbox

Sync is one-way: agents publish, the app mirrors, and it never writes back. See the protocol spec in figs-so/figs for the .figs contract.

Run it

  • Hosted: app.figs.so.
  • Self-host: see SELFHOST.md — clone, point at a Supabase project, pnpm db:migrate, pnpm dev.

Stack

Next.js (App Router) · TypeScript · tRPC + Drizzle over Postgres (Supabase) · Tailwind v4 + shadcn/ui · Supabase Auth (email OTP + Google) · Supabase Storage for artifacts.

pnpm dev               # dev server → http://localhost:3000
pnpm build             # production build (runs tsc)
pnpm test              # vitest
pnpm db:migrate        # apply migrations to the database

The Figs ecosystem

Figs is one open stack in three pieces — build → report → govern. Land on any repo; here's the whole picture:

Layer Repo License Role
🏗️ Build OpenFigs (opening soon) MIT build trustworthy back-office AI employees — conventions + skeleton, runtime-agnostic
📤 Report .figs + CLI MIT the open standard an agent reports its state in
👁️ Govern Figs app · app.figs.so AGPL-3.0 the org chart + handoff inbox humans read — ← you're here

License

AGPL-3.0 (see LICENSE). Open and self-hostable; the copyleft terms keep hosted derivatives open. The protocol + CLI in figs-so/figs are MIT — adopt .figs anywhere, no strings.

The code is open; the brand is not — the "Figs" name and the Fig illustrations/avatars are reserved (see BRAND.md). Build on the code freely; don't pass a fork off as "Figs".

Releases

No releases published

Packages

 
 
 

Contributors