VixlVixl
Docs
Changelog
GitHub
Docs
Changelog
GitHub
  • Get Started

    • Overview
    • Philosophy
    • Installation
    • Set up providers and models
    • Add a project
    • Create a project group
    • Your first chat
  • Concepts

    • How Vixl works
    • Chat modes
    • Permissions and approvals
    • Projects and home chats
    • Models and roles
    • Context
    • Code graphs
    • The .vixl directory
  • Using Vixl

    • Manage chats
    • Queue and stop messages
    • Review and restore changes
    • Compact and hand off long chats
    • Export a transcript
    • Work with plans
    • Orchestrate sub-agents
    • Best practices
    • Use the workbench
    • Shortcuts and the command palette
  • Customize

    • Providers
    • Models
    • MCP servers
    • Skills
    • Custom agents
    • Rules and AGENTS.md
    • Language servers
    • Appearance
    • Permission settings
  • Reference

    • settings.json
    • mcp.json
    • Custom agent frontmatter
    • SKILL.md format
    • Keyboard shortcuts
    • Chat statuses
    • .vixl layout
    • Managed components
  • Resources

    • Troubleshooting
    • FAQ
    • Privacy
    • Comparison
    • Roadmap
    • Brand and press
    • Changelog

Chat statuses

The left sidebar and the project Chats table show a short label (or an icon with that accessible name) for each chat. Running always wins. If the chat is not running, the attention label is shown instead.

LabelWhereMeaningWhat to do
RunningSidebar (dots) and tableA parent turn is in flight, or background sub-agents are still working after the parent finishedWait, or stop from that chat
Needs approvalSidebar and tableA tool is waiting on Allow / DenyOpen the chat and approve or deny
Needs inputSidebar and tableA question card is waiting for an answerOpen the chat and answer
Needs MCP authSidebar and tableAn MCP server needs sign-in or secretsOpen the chat and complete auth
DoneSidebar (dot) and tableThe last turn succeeded while this chat was not the open sessionOpen the chat to read the result
ErrorSidebar and tableThe last turn failed while this chat was not the open sessionOpen the chat to see the error
IdleProject table onlyNot running, and nothing needs youNothing. The sidebar shows no extra label for this state

New chats start idle. Stop sets the chat idle. A successful turn on the open chat clears Done. An error on the open chat does not set the Error label (the thread already shows the failure).

Compacting is an in-thread state, not a sidebar status. Nested agents in the thread show running, done, stopped, or error. Stop on a sub-agent route stops that helper only. Stop on the parent stops every nested agent for the chat.

MCP connection states (connected, starting, stopped, error, auth_required, refreshing) are server statuses, not chat statuses. See mcp.json.

See Manage chats for rename, pin, fork, and delete.

Edit this page
Last Updated: 9/30/26, 12:37 AM
Prev
Keyboard shortcuts
Next
.vixl layout