Torki Code

Horizon: The Browser Beside Your Work

12 min read · Checked against the product on 10 November 2026

Overview

Horizon is the browser built into Torki Code. It docks beside the conversation, so you can watch the app you are building while Torki works on it. It is a full browser too: search, open any website, follow links, and stay signed in to the sites you use.

Torki can work in Horizon with you. On your own local pages it reads and clicks without asking. On any other site it asks you first, and on banking, payments, email and government sites it never clicks or types. This article covers the browser itself and how Torki uses it. To open your sites already signed in, see Stay Signed In: Bring Your Sign-ins Over.

What it needs

Torki AI for Mac 1.10.22 or Torki AI for Windows, signed in. Each Torki account has its own Horizon, with its own sign-ins, history and saved pages. If nobody is signed in to Torki, Horizon still opens pages, but it records no history and forgets any sign-in when you quit.

Get started

1. Show Horizon

Click the globe at the end of the tab strip, to the right of your file tabs (its tooltip reads Show Horizon). Or press ⌘T for a new Horizon tab; this also switches to Code if you are on Home. Click the globe again (Hide Horizon) to put it away.

Drag the panel's left edge to make it wider or narrower; it is at least 320 pixels wide. Horizon remembers whether it was open.

2. Go somewhere

Type in the address bar ("Search or type an address") and press Return:

  • An address opens: localhost:5173, 127.0.0.1:8000/health, github.com or a full https:// link.
  • Anything else is a search, and the results open in Horizon. Horizon uses the engine chosen in Settings → Horizon → Search with: Google, DuckDuckGo, Bing or Brave Search. Google is the default.
  • A file name such as app.js or README.md counts as words and is searched for. Type http:// in front if you really mean a site with that name.
A new Horizon tab: the tab strip and address bar along the top, the Horizon mark, a box reading Search Google or type an address, and a card reading Stay signed in to GitHub, Vercel, Figma and 5 more, with Review sites and Import buttons
A new tab opens on Horizon's start page. The card offers to bring your sign-ins over from your everyday browser.

The start page

Every new tab opens on the start page. From the top:

  • The search box, under the Horizon mark. It reads "Search Google or type an address", or names the engine you chose in Settings → Horizon.
  • The "Stay signed in" card, which offers to bring your sign-ins over from the browser you use every day. It appears while you are signed in to Torki and a browser on this Mac has sites to suggest, until you import once or close the card. See Stay Signed In.
  • Running on this Mac — the development servers answering on this Mac right now. Each shows the name of its project folder (or the page's title when Horizon cannot tell), its localhost address and, when Horizon can tell, what made it, such as Next.js, Vite, Astro or Python. Horizon checks the ports development tools usually use (3000 to 3003, 4000, 4173, 4200, 4321, 5000, 5173 to 5175, 5500, 6006, 8000, 8080, 8081, 8888 and 9000) plus any server Torki started, and lists up to eight. The section is hidden when nothing is running.
  • Recently open — up to six pages you opened lately. A lock marks a page whose site you brought your sign-in over for. Before you have opened anything it reads "Pages you open will appear here."
  • Saved — the pages you starred. This section appears once you have saved one.

The bar

From left to right:

  • Back, Forward and Reload.
  • The site chip, at the start of the address. It says what kind of page this is: Local (a page served from this Mac, such as localhost, 127.0.0.1 or an address ending in .test), Secure, Not secure ("The connection to site is not encrypted. Do not type anything private here."), Signed in (a site you brought your sign-in over for), or the search engine's name on a page of search results. Click it for the site popover, below.
  • The address. On a page of search results it shows what you searched for.
  • The Torki chip, at the end of the address. It says what Torki may do on this page: Torki asks first, Torki can read, Torki allowed, Torki acts freely (your local pages), Torki never, Torki never acts (banking, payments, email and government sites) or, while it works, Torki is working.
  • The page tools: Mark up the page (pen), Point at something on the page (pointer) and Check this page at another size.
  • The star — Save this page. Click it again to Remove from saved.
  • ⋯ — the menu.

The ⋯ menu

The Horizon menu open over a local page, listing New tab, Reopen closed tab, Find in page, Zoom with minus and plus buttons around 100%, Downloads, Developer tools, Copy link, Open in your browser, Site settings, Bring sign-ins from your browser and Horizon settings
Everything else a browser does lives in the ⋯ menu.
  • New tab (⌘T).
  • Reopen closed tab (⇧⌘T) — brings back a page you closed since Torki started, newest first.
  • Find in page (⌘F while the page has the focus). A strip opens above the page with a count such as "3 of 12", or "No matches". Return goes to the next match, Shift-Return to the previous one, and Esc closes the strip.
  • Zoom — the − and + buttons, with the current size between them.
  • Downloads — a shelf under the page with your recent downloads, a progress bar while one is arriving, Cancel, and Show in Finder when it is done. Files go straight to your Downloads folder under a name that never replaces a file already there, and macOS checks them the way it checks downloads from any browser. With nothing downloaded yet, you see "Nothing downloaded yet."
  • Developer tools for the page.
  • Copy link — copies the page's address.
  • Open in your browser — the same page in your Mac's default browser.
  • Site settings — opens the site popover.
  • Bring sign-ins from your browser… — see Stay Signed In.
  • Horizon settings — Settings → Horizon.

Find, zoom, developer tools, copy link, open in your browser and site settings are greyed out until a web page is open in the tab.

The page tools

  • Mark up the page (pen) — Horizon takes a picture of the page and you draw on it with Draw and Box, with Undo for the last mark. Then choose Send to chat or Cancel. The picture is attached to your next message as "Marked up address", so you can circle what is wrong and say what you want.
  • Point at something on the page (pointer) — "Click an element to send it to the chat. Esc to cancel." Torki gets that element's selector, its text and its HTML, attached as "About label on address".
  • Check this page at another size — Phone (390×844), Tablet (768×1024), Laptop (1280×800) or Fit the panel. A page without a viewport meta tag gets the note "This page has no viewport meta tag, so a phone lays it out at 980px wide."

Tabs

  • Up to five Horizon tabs can be open at once. A sixth gets "Only 5 Horizon tabs can be open at once. Close one first."
  • The button at the end of Horizon's tabs (tooltip "New Horizon tab (⌘T)") opens another.
  • With the page focused, ⌘W closes the Horizon tab.
  • A tab whose page has stopped answering adds "Not responding" to its tooltip.

The site popover

Click the site chip, or choose Site settings in the ⋯ menu, to see what kind of page this is and to change what Torki may do on the site.

The site popover open under the Local chip for localhost, saying localhost:33813 is running on this computer, with a Torki on this site row set to Always allowed and an All site settings button
The site popover for a local page. Torki is always allowed on your own local pages, so the setting is fixed.
  • Torki on this site — Ask each task, Read only, Always allowed or Never. On a local page it is fixed at Always allowed.
  • On a banking, payments, email or government site a note says Torki never clicks or types there.
  • Sign out here — signs you out of this site in Horizon only. It is not offered on local pages or search results.
  • All site settings — Settings → Horizon.

Torki in Horizon

Looking at a page it built

After changing a page, Torki usually starts your dev server and looks at the result. That look happens in the background, not in Horizon: a Look at card appears in the conversation with the picture it took.

A Look at card for http://localhost:5173 in the conversation, with the screenshot Torki took shown under SAW
A Look at card: Torki rendered the page and checked the picture before carrying on.

Starting the dev server is a command, so it follows your permission mode like any other. See Permission Modes and Approvals.

Working in a page

When Torki needs to use a page — read it, fill in a form, follow a flow — it does so in Horizon, where you can watch. If no Horizon tab is open, Torki opens one. It always works on the Horizon tab you have in front of you.

While it works, the page gets a ring around it and a line underneath says what it is doing, for example "Torki is reading the page" or "Torki is clicking on the page". Click Stop on that line, or press Esc, to stop it.

What Torki asks first

  • Opening a local address, such as http://localhost:5173, raises a card that reads "Open http://localhost:5173 in Horizon". It follows your permission mode.
  • Your local pages (localhost, 127.0.0.1 and .test addresses): once a local page is open, Torki reads it and clicks and types there without asking. Turn this off in Settings → Horizon → Your local pages.
  • Every other site: the first time a task needs the site, Torki asks "Let Torki use site?". The card says what it wants: "Read pages on site — the text and a picture of what is on screen", or to read pages there "and click and type there to finish this task". Answer Allow for this task, Read only or Don't allow. An answer for the task lasts until you send your next message. Tick Always on site to keep it; it is kept for your Torki account, and you can change it in the site popover or in Settings → Horizon. The question is asked about the site Torki is actually on, so a link or a redirect cannot take it somewhere you did not allow.
  • Banking, payments, email and government sites: Torki never clicks or types on them, whatever you allowed. It may still read them when you allow it. This is the setting Settings → Horizon → Banking, payments, email and government, on unless you turn it off.
  • Passwords and card numbers: Torki never types into a password or card-number field. When it reaches one, the line under the page reads "Your turn: this page wants a password or card number. Type it yourself, then tell Torki in the chat."

Being signed in to a site does not let Torki use it. The question above is asked either way.

Good to know

  • Each Torki account has its own Horizon. Sign-ins, site data, history and saved pages belong to the account that made them, stay when you quit, and are never seen by another account on this Mac. To clear them when you sign out of Torki, turn on Settings → Horizon → Clear sign-ins when I sign out of Torki.
  • Browsing data — Settings → Horizon → Clear…, then Clear everything, removes this account's sign-ins, site data, cache and history in Horizon and closes its tabs.
  • No device or permission for any page. Every request from a page in Horizon for the camera, microphone, location, notifications or another device is refused. For a site that needs one, use Open in your browser.
  • The addresses of your open Horizon tabs are sent to Torki with each message, so "what is wrong with this page?" works. Close a tab you do not want Torki to know about.
  • Horizon only opens web pages. file: addresses and browser-internal pages are refused, and so is an address with a user name or password written into it: "That address has a name or password written into it, so it was not opened."
  • If a page tries, on its own, to open something that is not a web page, such as another app, Horizon stops it and shows "This page tried to go somewhere else".

Projects on a server

Horizon runs on your Mac, so localhost in Horizon always means this Mac. When Torki starts a dev server for a project on a server, it forwards it to this Mac once the server answers, and the address Torki reports is the one that reaches it from here. It uses the same port when that port is free here, and another one when it is not, so open the address Torki gives. For a dev server to show in Horizon, ask Torki to start it rather than starting it yourself in the server terminal. See Working on a Project on a Server.

When a page will not show

  • "This page did not load" — for your own app, usually the dev server is not running or is on another port. Start it, then click Try again.
  • "This page stopped responding" — the page's process ended. Nothing else you had open was affected. Reload it.

FAQ

Can I use Horizon for ordinary browsing?

Yes. Horizon opens any website, and searches open in Horizon too. Up to five tabs can be open at once.

Why does Torki ask before it uses a site?

Because a page can contain anything, and a click can buy or post something. Torki asks once per site per task, or never again if you tick Always on site. Your own local pages are the exception.

Can Torki see or type my passwords?

Torki never types into a password or card-number field; it hands those to you. Bringing your sign-ins over copies cookies, not passwords; see Stay Signed In.

Does Torki need Horizon open to check its work?

No. Its usual check, the Look at card, renders the page in the background. Horizon is for when you want to watch, or when Torki has to use the page.

Why am I still signed in to sites after relaunching?

Horizon keeps each Torki account's sign-ins on this Mac, like any browser. Sign out of a site from the site popover or Settings → Horizon, or clear everything with Clear….