Docs › Troubleshooting › Chat panel problems
Chat panel problems
Fix a blank or crashed chat panel, a run that seems stuck, messages that did not send, and attachments that did not attach.
On this page
- The chat panel is blank
- The chat panel hit an error
- AstraCode Settings is blank after a restart
- The send button says Log in
- A message you sent shows as Queued
- A run seems stuck
- Stop does not stop straight away
- Lost the connection to AstraCode
- This conversation is too long for the model
- A dropped file did not attach
- Nothing to attach from the terminal yet
- Open the AstraCode chat first
- Stop the current run before rewinding
- A beforeSubmitPrompt hook stopped this message
- There is no model picker under the composer
- Auto-Hide Editor When Empty does nothing
How the panel works is on The chat panel. Problems with the agent's work itself are on Agent run problems.
The chat panel is blank
The panel is empty, or shows Error loading webview: Could not register service worker.
Cause: the editor's web view cache is stale, usually after an update, or after AstraCode was once started with sudo.
- Run AstraCode: Repair the Chat Panel from the command palette.
- It asks Clear the editor's webview cache and reload? and names the two cache folders it deletes. Your chats, settings and extensions are not touched. Choose Clear and reload.
- If it says some cache files could not be deleted, they are owned by root. Quit AstraCode, run the
sudo rm -rflines it shows in a terminal, and open AstraCode again.
The chat panel hit an error
The panel shows The chat panel hit an error. Your conversation is safe: it is kept by the editor, not by the view.
- Choose Try again.
- If it comes back, choose New chat. Your past chats are still in history.
- If that fails too, run Developer: Reload Window.
- Report it with AstraCode: Report a Problem. Details for a report on the error shows the technical message.
AstraCode Settings is blank after a restart
- Close the AstraCode Settings tab.
- Open it again with AstraCode: Open Settings.
The send button says Log in
The button reads Log in, or sending shows Sign in to AstraCode to send this.
- Press Log in, or run AstraCode: Sign In.
- Approve in the browser. If that fails, see Sign-in problems.
A message you sent shows as Queued
The message sits at the foot of the chat marked Queued, with sends when the agent finishes.
Cause: a message sent while the agent is working waits for the run to end. That is the default, astracode.agent.sendDuringRun set to queue.
- Steer gives it to the running agent at its next step, without stopping it.
- Send now stops the agent and sends it.
- Click its text to edit it; it has not been sent yet.
- The arrows move it earlier or later in the queue; the cross removes it.
- To always stop the run and send, set Messages sent while the agent is working to Interrupt in AstraCode Settings > Agents.
A run seems stuck
Nothing seems to be happening, and the run has not ended.
Cause: almost always, the agent is waiting for you. Approval cards and question cards have no timeout.
- Scroll to the bottom of the chat and look for an approval card (Approve, Deny) or a question card (Continue, Skip).
- If the chat is not on screen, the editor shows a notification that the chat has a question for you. Choose Show.
- Check other chat tabs: a chat with a pending question shows Waiting for you in history.
- A command can also be running for a long time. Its card says Still running; choose Move to background (or press Ctrl+B) to let the agent carry on.
- If nothing is waiting, press Stop and send the message again.
Stop does not stop straight away
The button shows Stopping the agent and stays disabled for a while.
Cause: the run is finishing the step it is in, such as a command that is being ended. The button resets when it has.
- Wait for the button to turn back into Send.
- If it never does, run Developer: Reload Window. The chat is kept.
Lost the connection to AstraCode
The chat shows Lost the connection to AstraCode. Trying again until it is back; nothing is lost.
Cause: the network dropped during a run. The run waits and carries on when the connection returns.
- Check your connection, VPN or proxy.
- Leave the run alone; it resumes by itself. If you need to, press Stop and send the message again once you are back online.
This conversation is too long for the model
Cause: the conversation and its attachments no longer fit in what the model can read. Sending the same message again will not help.
- Click the context ring next to Send and choose Compact session, or run AstraCode: Compact Session.
- Or detach some files, or start a new chat with New Chat.
Compacting can also answer with:
| Message | What to do |
|---|---|
| Finish or stop the current run before compacting. | Wait for the run, or stop it, then compact. |
| Nothing to compact yet | The conversation is still short; nothing needs doing. |
| Could not summarise the conversation. Nothing was changed. | Try again, or start a new chat. |
| Could not shorten the conversation automatically | Start a new chat, or try Compact session. |
| Sign in to summarise the conversation. | Choose Sign In. |
A dropped file did not attach
The panel shows That drop arrived with nothing attached to it. or That drop carried nothing that can be attached.
Cause: some systems block dragging from Finder or the file manager into a panel, or the file is a type that cannot be attached. Binary files are skipped; text files are cut at 20,000 characters.
- Drag the file from the editor's Explorer instead.
- Or choose +, then Add files or photos.
- Or right-click the file in the Explorer and choose Add to Chat.
Nothing to attach from the terminal yet
Cause: Add to Chat from the terminal, or @Terminal, needs a command that ran with shell integration on, or some selected output.
- Run a command in the terminal, with the editor's shell integration on.
- Or select the output you want, then press Cmd+L (Ctrl+L on Windows and Linux).
Open a file to add it, or a selection of it, to the chat. means no file was open when you used Add Selection to Chat.
Open the AstraCode chat first
Commands such as Export Transcript say Open the AstraCode chat first. or Open the AstraCode panel first.
- Press Cmd+Shift+I (Ctrl+Shift+I on Windows and Linux) to open the chat.
- Run the command again.
Stop the current run before rewinding
Cause: a chat cannot be rewound while it is running.
- Press Stop, or wait for the run to finish.
- Use Rewind to just before this message again.
A beforeSubmitPrompt hook stopped this message
Cause: one of your hooks, or a project's, refused the message.
- Open AstraCode Settings > Customize > Hooks and read the Execution log.
- Fix or remove the hook. See Hooks.
There is no model picker under the composer
Cause: this is expected. AstraOne chooses the model, and the picker appears only when you use your own provider key and the gateway answers with the models it can use. Hover where it would be for the reason.
- You are not signed in, so the gateway has not been asked which models are available.: sign in.
- Can't reach the gateway: check your connection.
- To add a key: Bring your own key.
Auto-Hide Editor When Empty does nothing
The editor warns that the setting needs the "Toggle Editor Area Visibility" command, which this build does not have. The setting stays off in that build; there is nothing to fix on your side.
← Install and update problems Agent run problems →
All documentation
Get started
Using the editor
- Tab completion
- Edit and ask about a selection
- Reviewing the agent's changes
- Git: commit messages, branch review and conflicts
- Dictation
- Layout, themes and the settings page
Agent
- Agent overview
- Agent, Plan, Ask and Debug
- Approvals and permissions
- Plan mode
- Debug mode
- Tools
- Browser tools
- How the agent checks its work
- Checkpoints and undo
- Running several agents at once
- Subagents and background tasks
- Remote agents in GitHub Actions
- Infrastructure as code
Context
Workspaces
Connectors
- Connectors (MCP servers)
- Connector configuration reference
- Use AstraCode from Claude, ChatGPT and other apps
Extending AstraCode
CLI
Account and usage
- Usage and limits
- Bring your own key
- What AstraCode sends and keeps
- Reporting a problem and getting help
Troubleshooting
- Troubleshooting
- Sign-in problems
- Install and update problems
- Chat panel problems
- Agent run problems
- Connector problems
- Dictation problems
- Usage, billing and network errors
- CLI problems