Needs You

The Needs You page collects items across all your projects that require human attention. Agents flag these when they encounter decisions, risks, or actions that need your approval before proceeding.

This is your primary touchpoint for staying in the loop without micromanaging. Most of the time your agents work autonomously — this page surfaces the moments where a human call is needed.

What appears here

Type	When it's raised	Example
Approval request	Agent wants to take a high-risk action	Merging to a protected branch, deleting a resource, deploying to production
Conflict resolution	Agent hit an ambiguity it can't resolve alone	Merge conflict between two agents' changes, contradictory requirements
Flagged review	Agent wants a human to verify before continuing	Large refactor, security-sensitive change, config update
Blocked task	Agent needs information or access it doesn't have	Missing API key, permission denied, unclear spec

Reviewing items

Each item shows:

• Agent — Which agent raised it, and from which project
• Summary — What's being requested and why
• Context — Relevant code, commits, or logs that led to the request
• Age — How long the item has been waiting (oldest first)

Actions

• Approve — The agent proceeds with the action immediately
• Reject — The agent abandons the action and logs your rejection reason
• Comment — Provide guidance without approving or rejecting — the agent will adjust its approach based on your input

Notifications

When new items appear, you'll see a badge count on the Needs You sidebar link. Email notifications can be configured in Settings → Notifications.

When to act vs when to wait

Not every flagged item needs immediate attention. Agents are designed to self-heal in many cases.

Wait and let agents handle it:

• A single [GIT STUCK] alert — agents resolve these ~90% of the time on the next cycle
• One failing test — the QA agent will report it and the responsible agent will fix it
• An [ORPHANED SESSION] — collected automatically next cycle

Act promptly:

• Same alert appearing 3+ times in a row — something is genuinely stuck
• [DISK LOW] — clean up files or expand the VM's disk
• [GIT CORRUPT] — may need manual git repair
• No messages from agents for 2+ hours — the gateway may have stopped

See the Messages page for the full list of alert types and their urgency levels.

Relationship to project Approvals tab

The Needs You page is a cross-project aggregate view. Each project also has an Approvals tab in its detail page showing only that project's pending items. The same actions (approve, reject, comment) are available in both places.