Needs You

The Needs You page collects items across all your projects that require human attention. Your agent flags these when it encounters 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 agent works 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	Contradictory requirements, or an ambiguous change the agent can't resolve alone.
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:

• Project — which project raised it.
• 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. Your agent is designed to self-heal in many cases.

Wait and let your agent handle it:

• A single [GIT STUCK] alert — your agent resolves these ~90% of the time on the next cycle
• One failing test — your agent will report it and fix it

Act promptly:

• Same alert appearing 3+ times in a row — something is genuinely stuck
• [DISK LOW] — clean up files or expand your project's storage
• [GIT CORRUPT] — may need manual git repair
• No messages from your agent for 2+ hours — your project 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.