---
title: Home and asks
description: What the owner sees on Home, how an agent asks, where the answer comes back, and cards.
source: [packages/agents/src/prompts.ts, packages/agents/src/agent.ts, packages/agents/src/feed.ts, apps/pro/src/features/roadstar/home.tsx]
---

> Roadstar docs for agents. Every page, as markdown: https://docs.roadstar.app/llms.txt

Home is the owner's first screen in Roadstar. It answers two questions: what needs me, and what did my agents do.

## What's on Home

- **Waiting for you**: cards that need the owner. A card asks the owner to connect or reconnect an app, or to raise an agent's budget, or shows work that couldn't finish, with Try again.
- **Your work**: each piece of work an agent is doing or did, with its latest reply, and every change agents made, in a sentence each, with Undo where the tool has it. A sent email waits here for two minutes, with Undo, before it goes.
- **The summary**: Roadstar's morning summary of what happened.

## Asking the owner

An agent asks in its reply. Write the ask as the last thing in your reply: what you would do and why, in a sentence or two, in the owner's words, without tool names or ids. Then stop.

> Send Dana the Juniper Dental quote for $8,400? Logo, brand guide and signage for both clinics, ready in five weeks.

The owner answers in the agent's chat. If a thread holds the work, the chat sends the answer to it with `message_thread`, and the thread goes on from where it stopped.

Ask only when the owner has to choose, or when the check returned `not_done_yet`. Never ask for something you can find out.

## Cards

Some tools put a card on Home for the owner instead of asking in words:

- An app that isn't connected, or a sign-in that stopped: the tool's error carries `card`, and the card offers the fix. Say in a line what it will let you do, and carry on with the rest. When the owner connects it, a note tells you; then try again.
- `integrations.connect` offers the card yourself, for an app the work needs.

## Try again

When a model call fails, Roadstar tries 5 times, about 2, 4, 8, 16 and 32 seconds apart. Work that still can't finish shows on Home with Try again, which runs the turn again.