Home
Home page controls: empty state, conversation chrome, composer modes, sources, @ mentions, recommended questions, connectors, history, and errors.
Home is the project chat page. Prompts use project data and can link into Dashboard, Replays, Visitors, Issues, Funnels, or the Agents builder. There is no separate Chats index — sidebar Chats rows open Home with ?c=.
Routes
| URL | Meaning |
|---|---|
/projects/:id/home | Empty composer / greeting |
/projects/:id/home?c=:conversationId | Open thread |
Legacy /chats/:id | Redirects to Home with ?c= |
Legacy ?chat= on Home | Redirects to ?c= |
Page regions
| Region | What it is |
|---|---|
| Top bar | Title Home, optional conversation chrome |
| Main | Empty greeting + composer, or transcript + floating composer |
| Modals | Connect connector / connector intro when an @-mention or setup flow needs OAuth or manual credentials |
Empty state (no open thread)
Shown when there is no valid conversation chrome (bare /home, or a not-found ?c= behind the missing-page modal).
| Element | Copy / behavior |
|---|---|
| Avatar | HumanBehavior mascot, or the selected agent's avatar when an agent is active |
| Greeting bubble | Time-of-day greeting using the display timezone preference: Good morning / Good afternoon / Good evening, plus first name when known |
| Agent greeting | If an agent is selected: You are now talking to {agent name} |
| H1 | How can I help you understand your users? |
| Quote | “Make something people want” — Paul Graham |
| Config empty title (internal) | Ask Human Behavior about this project |
| Composer placeholder | Ask anything, or type @ to add agents and integrations… (the @ is emphasized in the placeholder node) |
Conversation chrome (open thread)
Appears when ?c= is set (or messages already exist) and the conversation is not marked not-found.
| Control | Behavior |
|---|---|
| Top-bar icon | Switches from Home icon to message icon |
| Editable title | Click to rename; shows Untitled / muted pending while the AI titles the thread; skeleton while hydrating |
| New chat | Clears session and navigates to /home (no ?c) |
View history (ChatHistoryDropdown) | Lists conversations; selecting one navigates to /home?c=:id |
| More actions (⋯) | Menu with Delete (destructive). Deletes the open conversation, then runs New chat |
URL promotion
When the first message creates a conversation from bare /home, the client router.replaces to /home?c=:id without remounting so the stream continues without a skeleton flash.
Composer
Shared with the floating bottom chat on other routes (BottomPanelChatContent).
Modes
Opened from the composer settings control:
| Mode | Label | Description in UI |
|---|---|---|
default | Default | Searches and runs actions. |
ask | Ask | Answers only, no actions. |
Sources chips
Toggleable context sources (labels as shown):
| Chip id | Label |
|---|---|
dashboard | Dashboard |
replays | Replays |
users | Visitors |
issues | Issues |
funnels | Funnels |
These hint where the assistant may pull evidence from; they are not separate navigation.
@ mentions
Typing @ suggests project agents and integrations.
| Mention target | Behavior |
|---|---|
| Project agent | Message is routed with that agentId; switching agents mid-thread can reset the conversation when an agent was already selected |
| Integration / connector | May open Connect flows: OAuth intro modal or manual ConnectConnectionModal |
After OAuth returns with ?oauth= / ?status=, Home refreshes integrations and strips those query params.
Recommended questions (Home only)
When showRecommendedQuestions is on (Home full placement), chips include:
- What's driving visitor churn this month?
- Which features have the highest engagement?
- Where do visitors drop off during onboarding?
- Compare activity between free and paid visitors.
- Summarize this week's most-watched session replays.
Quick actions
Composer can also surface quick-action chips such as Create a custom agent and UX improvements based on usage (marked New when shipped that way). Selecting create-agent handoff writes a builder chat handoff and navigates to /agents/new?from=home (optional setupChat=).
Attachments & model
File input and model picker follow the shared composer; model id is sent with the run when selected.
Chats history (sidebar)
There is no /chats index route in the shipped product.
| Behavior | Details |
|---|---|
| Sidebar Chats | Lists conversations; click opens /home?c=… |
| Empty list | May render nothing (no dashed new-chat row) |
| Presentational icons | Some “Chat options” / “See all chats” / “New chat” icons in the section header are tooltips only — use New chat inside Home or open a row |
| Permissions | Members typically see their own threads; owners can see all |
Floating chat on other pages
Non-Home project routes can show a floating bottom chat. That surface uses ?chat= separately from Home’s ?c=. Same composer ideas (New chat, @ mentions, modes/sources) apply; do not confuse the two query params.
States & errors
| State | UI |
|---|---|
Missing / unauthorized ?c= | “page couldn’t be found” style modal over genuine Home empty state; conversation chrome hidden |
| Hydrating open thread | Title skeleton; avoid empty-state flash |
| Setup / connector error | Red text above the chat: setup error string |
| Run failed | Red dot on sidebar chat row (Run failed) |
Good first questions
- “What pages did people visit in the last 24 hours?”
- “Show me sessions with errors yesterday.”
- “Where do users drop off after /pricing?”