Troy / Guides
Using the browser
Tabs, the address bar, the new tab page and its shortcuts, failure pages, crash recovery, zoom, and the agent panel in Troy's own chrome.
On this page
Troy’s window has two layers. The top 88 pixels are Troy’s chrome: the tab strip and a toolbar with back, forward, reload, the address bar and the agent panel button. Below it, each tab is a separate Chromium view, so pages render exactly as Chrome renders them and cannot repaint or script the chrome.
Troy is deliberately small. It has the features a person needs to sign in and work alongside an agent, and leaves out the rest (bookmarks, find in page, context menus, tab reordering). Where it behaves differently from Chrome, the reason is usually a default that collects or exposes less: no history, no suggestions while you type, no device permissions.
Tabs
- New tab: Cmd+T (Ctrl+T), or the + button at the end of the strip.
- Close tab: Cmd+W (Ctrl+W), or the cross on the tab. Focus moves to the neighbouring tab, not to the far end of the strip. Closing the last tab opens a fresh new tab rather than leaving an empty window.
- Each tab shows its favicon, or a spinner while it loads. A favicon that fails to load is hidden rather than shown as a broken image.
- A thin progress bar on the seam between the chrome and the page shows page loading.
There is no tab reordering yet.
The address bar
Focus it with Cmd+L (Ctrl+L). What you type is resolved like this:
- A string with a known scheme, such as
https://example.com/, loads as typed, minus tracking parameters. - A bare host such as
example.comorexample.com:8443/pathloads overhttps. localhost, an IPv4 address or a bracketed IPv6 address loads overhttp, solocalhost:3000works.- Anything with a space, or that does not look like a host name, is searched with Google.
- Refused schemes such as
javascript:show a notice saying why. See Privacy and permissions.
There are no suggestions while you type.
The new tab page
- Search box: the same rules as the address bar. It is a plain form, so it works even if the page’s script fails to load.
- Settings: the gear button in the corner. Remember history (off by default) and Block trackers (on by default). In v0.1.5, turning on Remember history records nothing; on main it keeps a list in
history.json(see Privacy and permissions). - Hints under the search box list the three shortcuts worth knowing: Cmd+L for the address bar, Cmd+T for a new tab and Cmd+Shift+A for the agent panel.
Shortcuts (v0.1.5 only)
v0.1.5 has a grid of shortcut tiles you add by hand with Add shortcut: up to 12, http and https only. Adding the same address again updates its title. Each tile shows the site’s own /favicon.ico or its initial, never a third-party favicon service. Opening a tile goes through the address bar rules.
On main the grid is removed. The code comment explains why: the add dialog had been broken for weeks, and a grid nobody can fill is worse than no grid.
When a page fails
A failed load shows a Troy page in the tab that keeps the address you asked for in the address bar, with a plain reason such as “That address has no server behind it. Check the spelling.” or “The server refused the connection.” Unknown Chromium errors keep their ERR_ token in parentheses so they can still be searched.
Reload, or Try again on the page, retries the address that failed, not the failure page. A failure that arrives after you have already asked for a different address is dropped, so a slow error cannot overwrite the page you wanted.
If a tab’s renderer crashes, the tab shows “The page stopped responding” with the reason, instead of staying blank.
When Troy itself hits an error
An uncaught error in the main process would normally close every tab. Troy catches it, shows “Something went wrong inside Troy. It stayed open; the details are in troy-errors.log.”, and keeps running. The log is in the profile folder.
The agent panel
Cmd+Shift+A (Ctrl+Shift+A), View > Toggle Agent Panel, or the aperture button at the right of the toolbar. The panel is 340 pixels wide and the page shrinks beside it rather than being covered.
read this page reads the active tab over the Chrome DevTools Protocol (CDP):
- In v0.1.5 it shows the page’s address, its character count and its visible text, up to 4,000 characters.
- On main it runs the read pipeline and shows the address, title, block and region counts, how long the read took, whether the page settled, and the page as Markdown.
The panel has no chat or model connection. It reads; it does not act. See How Troy reads a page.
Zoom
- Actual Size: Cmd+0 (Ctrl+0)
- Zoom In: Cmd+Plus (Ctrl+Plus)
- Zoom Out: Cmd+- (Ctrl+-)
Zoom changes in half steps, per tab. Pinch zoom is limited to three times.
Opening Troy with an address
An http or https address passed on the command line opens in the first tab instead of the new tab page. On macOS the app declares itself able to open http and https links, so the system can offer it as a browser.
Window
Troy remembers the window’s size and position between launches. The default is 1280 by 860 pixels and the minimum is 520 by 400. On macOS the chrome uses the system’s translucent window material; elsewhere it is a solid dark panel.
On macOS, Troy > About Troy shows the version. On main it also carries a short description of the project.
Developer tools
View > Toggle Developer Tools (Alt+Cmd+I on macOS, Ctrl+Shift+I elsewhere) opens DevTools for the active tab.
All menu shortcuts are listed in Keyboard shortcuts.