Welcome to FlowGraph

The five-minute guide

Thirty loose threads. One word. That's what FlowGraph does with your ideas: it lets them wander, then weaves them into something you can trust. This page teaches you the loom.

Start the tour ↓ Skip to the app
scroll · the threads know the way
01 capture what you know 02 verify what AI adds 03 view it any way you need
Step 01 · Learn six words

FlowGraph fits in six words.

Everything nests. A workspace holds projects, a project holds canvases, a canvas holds cards, a card holds sections, a section holds atoms. Click any layer to see what it does. That's the whole vocabulary.

Workspaceyour whole world
Projectone initiative's home
Canvasone goal, one graph
Cardone piece of knowledge
Sectionone labeled part
Atomone approvable fact
Checkout depends on auth-v2
click a layer · the panel explains it
Layer 1 of 6

Workspace

Your whole world. All your projects and canvases live here, on your machine, in your browser. Nothing leaves without your say-so.

Where you'll find it: the sidebar, top level. You'll rarely think about it, and that's the point.
Step 02 · Pick your road

Two ways to start.
One place to arrive.

Road A · Compose with AI
Road B · Add a card yourself
You typeintent
"Launch my podcast"
AI draftsplan v1
12 cards, ghost ink
You reviewapprove
Keep 10 · reject 2
You double-clickcanvas
A blank card appears
You name itcard
"Book first guest"
You connect itedge
depends on · outline
canvas · my-podcast · live ● recording provenance

Both roads end on the same canvas. AI-born or hand-made, every card obeys the same rules.

Step 03 · Build your first card

Six moves. That's the craft.

MOVE 1 / 6

Add a card

Double-click any empty spot on the canvas, or press C. A ghost card appears where you clicked. Type its name, hit enter, done. It's saved locally before you can blink.

double-click or C
+ new card · type a name
MOVE 2 / 6

Add a section

Open the card and add sections: labeled parts like Owner, Risk, Sources, Actions. Sections keep a card scannable. Think of them as the card's chapters.

S inside a card
Book first guest action
Owner
You
Risk
Guest availability in July
+ add section
MOVE 3 / 6

Fill it with atoms

Inside a section live atoms: single facts, one line each. Each atom can be approved, locked, and traced on its own. Green dot means verified. Amber means someone (or some AI) still owes it a look.

Section · Actions 3 atoms
Shortlist 5 guests verified
Draft invite email verified
Confirm recording date proposed
MOVE 4 / 6

Connect your cards

Drag from a card's edge port, or press E, and land on another card. Then name the line: depends, feeds, blocks, approves, or coin your own. An unnamed line is a doodle. A named line is knowledge.

E or drag from a port
Action
Book first guest
depends
Card
EP-001 outline
feedsblocksapproves+ your own
MOVE 5 / 6

Assign a reviewer

Every card can name the human who answers for it. Pick yourself, a teammate, or leave an agent as drafter, but an agent can never be the approver. Trust needs a name.

NYou MMaya Agent · drafts only
MOVE 6 / 6

Schedule the review

Facts rot. Give the card a review date and FlowGraph queues the re-check in a calm calendar. Nothing you verified stays "true" forever without being asked again.

◔ review due · in 30 days · auto-queued
Step 04 · Let AI in

AI drafts. You hold the pen.

Two habits to learn. When AI proposes something, it lands in your review inbox as ghost ink: approve it or reject it. And when a card feels thin, ask AI to improve it: every suggestion is still just a proposal. Drop PDFs and docs in anytime; they become smart cards your AI grounds itself on.

habit 1 · review the ghost ink
Proposedby claude-opus
Add outro music licensing check
try it · nothing is written until you say so
habit 2 · improve a card with AI
Book first guest
owner · you
actions · 3 atoms
each suggestion is a proposal · approve to apply
Step 05 · The cheat sheet

Eight moves you'll use daily.

Pin this in your head. Almost everything in FlowGraph is two keystrokes away, and everything is undoable, so press keys bravely.

C

New card

Or double-click empty canvas. Ghost appears, name it, enter.

S

New section

Inside a card. Owner, Risk, Sources, or invent your own.

E

Connect + name

Draw an edge, then say what it means: depends, feeds, blocks, approves.

L

Lock an atom

A locked fact can never be overwritten by any model. Law.

Z

Undo anything

Any patch, any AI change, even an entire import. Reversible by design.

JKA

Triage reviews

Walk the inbox with J and K, approve with A. Keyboard speed.

drop

PDF → smart card

Drag a document onto the canvas. It becomes a card others can point at.

.fgraph

Export a canvas

One portable file with everything inside, scrubbed of what you didn't share.

Step 06 · Change the lens

Capture once. Look at it every way.

You never rebuild your knowledge for a different meeting. The same cards rearrange live: canvas for thinking, swimlanes for owners, kanban for status, timeline for the clock, outline reads like a document, logos shrinks cards to their tool tiles, executive is the one-glance altitude. Each lens remembers how you arranged it.

lens · canvas same atoms · zero re-entry
You
Maya
Agent
Proposed
In review
Verified
Week 1
Week 2
Week 3
Week 4
🎙 My podcast
6 cards · 5 connections · reads like a doc
auto-morphing · click a lens to take over
Step 07 · The map

You can never be lost here.

Along the bottom of FlowGraph runs the lineage timeline: your product's whole life, from first idea to reviewed graph, on one line. Every screen knows where it sits on that line. Watch your work evolve stage by stage, and jump to any moment of it with one click. Most apps give you pages and a back button. FlowGraph gives you a map with a you-are-here pin.

You are here
stage 03 · build · the canvas, live click the rail to jump
"Launch my podcast by September"
▤ niche-research.pdf▤ gear-list.md+ add a source · optional
claude · v3 · 8.6gpt · v2 · 7.9gemini · v1 · 7.4
Workstream · Content pipeline · 4 actionsgrounded · 2 sources
Workstream · Guest booking · 3 actionscritique · gap repaired
Workstream · Publish & distribute · 3 actions1 assumption flagged
Goal · verified
Launch the podcast
Action · in review
Book first guest
Card · proposed
EP-001 outline
Publish episode → mcp · podcast.upload▶ run · gated
Create calendar hold → mcp · calendar.createran · test passed
Every run leaves a trace on its cardaudit
Guest availability · re-check2d overdue
Gear list still current?due in 5d
Launch date confirmedre-ratified ✓
workspace / my-podcast / canvas / card #12 · every breadcrumb is clickable too
auto tour · playing · click any stage to take over
Step 08 · Bring your own AI

Use the AI you already pay for. Three doors in.

FlowGraph never asks you to buy another AI subscription. All three doors end at the same governed canvas — every write lands as a proposal with a receipt, whoever made it.

Door 1 · your agent — works today

Claude or ChatGPT, over MCP

Connect FlowGraph as an MCP server and the subscription you already have does the reasoning. Your agent reads verified facts and proposes through the same gate you use.

settings → api & docs → copy-for-ai

Door 2 · your keys — works today

Any provider, in Settings

Paste an API key from any provider — one OpenRouter key unlocks every model family. Compose, compare models, judge, ensembles: all with your keys, priced per run, shown before you spend.

settings → providers

Door 3 · local — $0, zero egress

Ollama on your machine

Point FlowGraph at a local model and nothing ever leaves your computer. Honest about the trade: less planning power, zero cost, total privacy.

settings → providers → local

Next up, the same canvas grows a play button: the Agent view turns your approved plan into runnable actions with three honest greens — dry-run, live, human-approved — plus a command line: flowgraph "your intent". Every run governed, receipted, and priced.

The recap

You're ready.

  • Six words: workspace, project, canvas, card, section, atom.
  • Two roads in: compose with AI, or double-click a card into being.
  • Six moves: add a card, add sections, fill atoms, connect, assign a reviewer, schedule the review.
  • Two habits: approve ghost ink, improve cards with AI.
  • Eight keys: the cheat sheet does almost everything.
  • Seven lenses: canvas, swimlanes, kanban, timeline, outline, logos, executive. One truth.
  • Three doors for AI: your agent over MCP, your own keys, or local models.
  • One map: the lineage timeline. You literally cannot get lost.

this guide is the seed of flowgraph's guidance engine · soon the app itself will walk you through these steps, live, as you work

The canvas is waiting.

Open it, press C, and make your first card. You already know the rest.