Web App
Chat with your squad from a browser, with no app to install.
The dashsquad web app is a page that you open in your browser to chat with your squad. You do not install it. It works on a laptop, a shared computer or a phone browser.
The web app reaches your HQ through the same hosted relay as the iOS app. See Remote Access.
The web app does not replace Desktop. Desktop still runs on the Mac with your squad. The web app is a hosted page that connects to that HQ.
Before you start
Your HQ must have remote access first. The Desktop setup wizard sets this up. To check, open Settings → Devices in Desktop. Make sure that Desktop shows HQ ready: followed by the HQ name. See Remote Access.
Sign in and chat
Sign in
Sign in with your dashsquad account. Use the same account as in Desktop.
Select your HQ
The page shows Choose an HQ to connect to. and a list of your HQs. Click the HQ that you want to use.
The list shows each HQ by the name that you gave it in Desktop. If an HQ has no name, the list shows HQ and the first 8 characters of its id. When the HQ reports its version, the row also shows it, for example HQ v0.11.1.
After you connect, the top bar shows the name of the HQ.
On this browser, the web app then opens that HQ directly the next time.
Start a conversation
Open a conversation, or start a new one. Chat with your agent as you do in Desktop or in the iOS app. If the agent has an unused conversation, the app can open it instead of a new one.
The web app shows the same conversations as Desktop and the iOS app. A message that you send here also shows on your other devices.
To use a different account, click Sign out. This button is on the HQ list and in the top bar.
The top bar
The top bar has these tabs:
| Tab | Use |
|---|---|
| Conversations | Your conversations and the chat |
| Skills | Select an agent and read its skills. Each skill shows its source: Built-in, Installed, Added or Learned. You cannot change skills here. |
| AI Providers | Manage the API keys of your HQ. This tab shows only when your HQ supports it. |
| Devices | Paired devices, and the settings for this browser |
When a conversation is open, the top bar also has Tasks. It opens a panel with the sub-agents of the conversation. See Sub-agents.
Agents and their chats
The conversation list shows your agents under Agents. Click an agent to show or hide its chats. The newest chats show first. When an agent has more than five chats, click Show all to see all of them, and Show fewer to see five again.
- To start a chat with an agent, click + next to its name. For a disabled agent, + is not available.
- An agent with no chats shows No chats yet. Click New chat to start one.
- The agent of the open chat opens automatically. The list highlights the open chat.
- Search finds chats from all agents. Each agent with a match shows the chats that match.
- New conversation at the top of the list also starts a chat. When you have more than one agent, it asks you to select the agent.
On a narrow window, the conversation list is in a menu. Click ☰ to open it.
With a conversation open, press Tab to show Skip to message box. Activate the link to focus the message box.
In the conversation list, Tab moves between rows. From a row, Right Arrow enters its actions. Left Arrow and Right Arrow move between the actions. Escape returns to the row.
If a part of the conversation list does not load, the list shows Some conversations did not load. Click Retry to load the list again. Until the full list loads, search finds only the conversations that loaded. If none of them match, the list shows No loaded conversations match your search.
Guide work while it runs
You can type while your agent responds. Click Send, and dashsquad sends your message as a Steer or a Follow Up:
- A Steer changes the response in progress. dashsquad labels it Auto-steered.
- A Follow Up waits in the queue and starts after the current response. dashsquad labels it Auto-queued.
If dashsquad is not sure, it asks you to choose Steer or Follow Up. To choose yourself, press Ctrl+Return (Cmd+Return on a Mac). If you close the choice, dashsquad keeps your text and images. You can edit or remove a queued Follow Up before it starts.
Automatic routing is an HQ setting. To change it, go to Settings → Chat in Desktop. There, you can also see what happens without an OpenRouter key.
The queue is the same on all your devices. Stop ends the current response, and the queue waits. If you stop a response or a response fails, the queue shows Follow Ups paused. Examine what occurred, then click Resume Follow Ups. Until then, the composer shows Follow Ups paused. Resume or remove them before sending. If the HQ is older than the app, the app tells you to update the HQ.
Goals and squad messages
When a conversation has a goal, a band above the message box shows the goal. It shows the state, for example Working, Paused, Blocked, Waiting for input, Waiting to retry or Completed. Click Details to see Checks, Next action and Limits.
The band has no buttons. To pause or resume the goal, type a command. The band tells you which one: Type /goal pause to pause it. or Type /goal resume to resume it. To edit or clear the goal, use Desktop or the iOS app.
The web app also shows the squad messages of the agent:
- A message that the agent sent shows Sent to and the receiver, with Delivered or Not sent.
- A message from a different agent shows Message from and the sender. Click Show more to read a long message.
- Click Thread · and the number of messages to open the thread. In the thread, click Pause thread, Resume or Close thread.
- A thread that you closed shows Closed by you. A new message starts a new thread.
The web app shows goals and squad messages only when your HQ supports long-horizon work. If they are not there, update your HQ.
Set the effort
If the model of the agent supports effort levels, a list shows next to Send. Choose Default or a level for this conversation. The level applies from the next reply. See Extended thinking.
Approve this device
If your account has a trusted iPhone or iPad, a new browser must get approval from a trusted device before it can chat.
In this case, the web app shows Approve this device, a QR code and this message:
Waiting for approval — scan this code with the dashsquad app on your phone.
Open the approval screen
On your iPhone or iPad, open dashsquad, go to Settings, and tap Approve a device.
Scan the code
Scan the QR code in the browser.
Approve
The phone shows the name of the browser and the HQ. Tap Approve.
The web app then continues automatically after some seconds.
If no iPhone or iPad is signed in to your account, a new browser connects immediately. After the first iOS device signs in, each new browser needs approval.
If nobody approves the request, the web app shows one of these messages:
| Message | Meaning |
|---|---|
| Approval declined. You can try again from the HQ list. | A person tapped Deny on the phone. If that was not you, find out who else has access before you try again. |
| The code expired. Try again from the HQ list. | Nobody approved the request in time. Go back to the HQ list to get a new code. |
Approve on the same phone
If you use Safari on your trusted iPhone or iPad, tap the QR code or Open in dashsquad. The app opens that device request. Check the browser name and HQ, then tap Approve or Deny. Return to the same Safari page. It continues to check for your decision.
Keep the page open if the app does not open. You can scan its code with another trusted phone from Settings → Approve a device. Some custom account services offer the code scan alone. The link stays available until the request expires or reaches a decision.
The app must already be signed in to the same account and trusted to approve devices. If it asks you to sign in, close the request, sign in through the app, and open the device approval again. Opening the link does not sign you in or approve access automatically.
Manage your devices
Click Devices to see each device that is paired with this HQ, with its type. The current browser shows This device.
To disconnect a device that you do not know or do not use, click Revoke next to it, for example a shared or public computer. If you revoke the current browser, the web app signs it out of the HQ and shows the HQ list again.
A revoked browser stops immediately. If it has an open chat, the chat disconnects at once. A revoke does not change the access of other devices, and your conversations stay on the HQ.
The Devices screen also has three settings. Location and Composer apply only to this browser. Usage data applies to your full account.
- Location: select Share precise location to send your approximate coordinates to your agent. Your agent always knows your time zone and region. Precise location needs a secure (HTTPS) connection to your HQ.
- Usage data: clear Share usage data to stop usage data for your account on all your devices. Refer to Usage data.
- Composer: select Pressing Return sends the message to make Return send. If you do not select it, Return starts a new line and Cmd+Return (Ctrl+Return) sends.
Manage AI provider keys
Click AI Providers to see the providers of your HQ and the names of their keys.
- To add a key, click Add key, paste the key, and click Save key.
- To change a key, click Replace.
- To delete a key, click Remove, then Yes, remove.
The HQ keeps the keys encrypted and shares them with Desktop. The web app never shows a saved key again.
To use a Claude or ChatGPT subscription, click Sign in with Claude or Sign in with ChatGPT and follow the instructions. See AI Providers.
If the AI Providers tab is not there, update your HQ.
Live browser view
When an agent with the browser tool opens a browser, View browser shows in the top bar. Click it to see the browser of the agent in a column next to the chat. On a window that is 768 px wide or less, the view fills the screen.
Between turns, the view shows You have control. Then you can click, type, paste and scroll in the page yourself, for example to solve a CAPTCHA. Only one live view can be open for each agent browser. If you open it here, the view in Desktop closes. See Browser → Live view.
Error messages
| Message | Cause | Action |
|---|---|---|
| <name> is offline. Start the HQ on that computer, then try again. | The HQ or network connection is unavailable. | Start the HQ on that computer. Then select the HQ again. |
| Your HQ '<name>' is unreachable. | The computer with your HQ is off, asleep, or has no internet connection. | Start or wake that computer and examine its internet connection. The web app connects again automatically. |
| This HQ needs to be re-enrolled from Desktop before web access works. | The HQ got remote access before the web app existed, so the web app does not have the data that it needs. | Open Desktop on that computer one time. Desktop updates the HQ automatically when it starts. Then select the HQ again. |
| Your web session for this HQ was revoked. Pair again to continue. | A person revoked the access of this browser, from a Devices screen. | The web app shows the HQ list. Select the HQ again to connect. If you did not revoke it, look for unknown devices on your other apps. |
| No HQs linked to your account yet. Open Desktop → Settings → Devices → Remote access to enroll this machine. | Your dashsquad account has no HQ. | In Desktop, go to Settings → General and click Set up remote access in the HQ card. |