AI Decomposition

Syncflow uses AI to break your task into small, ordered steps called 'crumbs' -- each with a title, description, time estimate, and research notes.

Open your task

After creating a task, navigate to the task page from your dashboard. You will see the task details along with a prominent Decompose with AI button.

Click "Decompose with AI"

The AI reads your title, description, and AI instructions. You will see progress messages while it works -- this typically takes 5-15 seconds depending on the complexity of your task.

Review the generated crumbs

Each crumb the AI creates includes:

Title -- a concise action item
Description -- what to do and why
Time estimate -- between 5 and 60 minutes
Order number -- the recommended sequence
Research notes -- tips, links, or context the AI thinks will help

AI Providers

The free tier uses Groq (Llama models) by default -- no API key needed. If you prefer a different model, you can bring your own key for Claude, ChatGPT, or Grok. Configure this in Settings → AI Provider.

Groq (default) -- fast, free, no setup required
Claude (Anthropic) -- bring your own API key
ChatGPT (OpenAI) -- bring your own API key
Grok (xAI) -- bring your own API key

Usage Limits

On the Free plan, you get 5 AI decompositions per month. Each time you click "Decompose with AI" counts as one use, whether you keep the results or not.

The Basic plan (€2.99/month) gives you unlimited decompositions. Check your remaining usage in Settings → Plan.

Tip: If the decomposition does not match your expectations, refine your task description and AI instructions, then decompose again. More specific input leads to better crumbs.

Via the API

You can also trigger decomposition programmatically:

POST /api/tasks/:id/decompose
Authorization: Bearer YOUR_KEY
Content-Type: application/json

{
  "instructions": "Break into 15-min chunks"
}

See the API Reference for full details.

← Create a Task Refine & Edit→

W

O

R

K

I

N

G

O

N

I

T

.