Integrated browser
Use the browser built into each conversation to preview your app, point the agent at page elements and share annotated screenshots.
Each conversation has its own Session browser. It shows the same page to you and to the agent, so you can check its work and show it exactly what to change.
Open the session browser
- In the Environment panel on the right of the conversation, click Session browser. A green dot shows that it is open.
- When the agent opens a web page, the browser appears on its own.
The browser opens beside the conversation. Click Full screen browser to give it the whole area, and Shrink browser to go back. The close button hides the browser pane.
Sessions belong to the conversation: another conversation has its own browser and its own tabs. Closing the last tab stops the browser.
Browse
The toolbar has:
- Tabs, shared with the rest of the Conversation workspace (Neoo Design, Simulator, Sub-agents, opened files and media), up to 3 browser tabs. + (Add to workspace) opens a menu: Browser tab, Neoo Design, Simulator and Sub-agents when available; choosing a surface that is already open just selects its tab. A marker shows the Tab currently used by the agent.
- Back, Forward and Reload.
- The address bar. Type an address and press Enter.
- Open in system browser to open the current page in your usual browser.
- Preview device, the gear for Browser settings, and the full screen button.
When the browser has the focus, you can use these shortcuts. Use ⌘ on macOS and Ctrl on Windows.
| Shortcut | Action |
|---|---|
| ⌘L / Ctrl+L | Go to the address bar |
| ⌘R / Ctrl+R | Reload |
| ⌘T / Ctrl+T | New tab |
| ⌘W / Ctrl+W | Close the tab |
| ⌘[ and ⌘] / Ctrl+[ and Ctrl+] | Back and forward |
| ⌘⇧[ and ⌘⇧] / Ctrl+Shift+[ and Ctrl+Shift+] | Previous and next tab |
Check other screen sizes
Open Preview device and choose Full width or a device from the Desktop, Tablet or Mobile groups. Neoo remembers your choice as the default device.
Show the agent what to change
The browser has tools to point at things on the page:
| Tool | What it does |
|---|---|
| Cursor (normal interaction) | Click and type in the page as usual. |
| Select an element (context for the AI) | Click an element to add a Browser element card to your message. The agent receives its selector and the page address. |
| Annotation rectangle and Annotation text | Draw boxes and write notes on the page. |
| Send annotated capture to the AI | Attaches a screenshot of the page with your annotations to your message. |
| Clear annotations | Removes your boxes and notes. |
When the agent uses the browser
- A blue pointer appears only while the agent clicks, moves or scrolls in the page, then fades out a few seconds later. Your own mouse never moves it.
- If the page opens a dialog (alert, confirmation, question or Leave this page?), it shows on top of the browser. The page stays paused until you answer it with OK, Cancel, Leave or Stay; the agent can also answer it.
- The tab you are looking at stays open while the browser pane is visible, even if the agent works in another tab.
- If the connection to the page drops (the page crashed or the tab was recreated), the browser reconnects on its own and reloads a crashed page.
Browser settings
Click the gear to open Browser settings:
- Zoom, from 50% to 200%.
- Appearance: System, Light or Dark.
- Open clicked links: In Neoo or External browser. Ctrl or Cmd + click always opens links outside Neoo.
- Profile for this conversation, Incognito and new profiles. Switching restarts this browser and closes its tabs. Profiles don't share logins with other conversations.
- Import existing logins to reuse sessions from a browser installed on your computer. Passwords, passkeys and local storage are not imported, and some sites ask you to sign in again.
Links in conversations
Click a localhost link in a conversation to open it in the integrated browser; other links open in your usual browser. Right-click a link (on a Mac: two-finger click or Control-click) for Open in integrated browser, Open in external browser and Copy link.
Conversations of another computer
In Remote conversations, the conversation runs on your other computer but the integrated browser runs on the computer in front of you. A localhost link of the other computer opens through Ports: Neoo uses the port it opened here, even when it had to pick another number because the original port is busy, and opens a shared port that is not open yet. If the other computer doesn't share that port, the page can't load.
Integrated browser or your own browser
The agent always uses the integrated browser for localhost, local files and addresses on your local network. For other websites, it uses your own browser when the Neoo Browser extension is connected and online. See Connect your browser.