The command bar

Chat with the assistant

Type a question in the command bar and press Tab. Arx's assistant answers in a panel beside the page, on your own Claude or ChatGPT sign-in.

Arx has a built-in assistant for quick jobs: summarize the page, find something in your tabs, look up a fact. Type in the command bar, press Tab, and the answer appears in a chat panel on the right side of the window. Answers are short on purpose. For bigger work, the assistant says so and points you to a full agent app.

Type a question in the command bar and press Tab: the chat panel opens beside the page and the answer streams in. ⇧ Esc hides it.

Before you start

The assistant runs on your own plan, through the command-line app of whichever provider you use. Arx never asks for your password and never sees your sign-in. You pick Claude or ChatGPT per chat, and set the default in Settings.

Claude, through Claude Code:

  1. Install Claude Code.
  2. In Terminal, run claude auth login and sign in with your Claude account (Pro, Max, Team or Enterprise).
  3. Come back to Arx and ask.

ChatGPT, through the Codex CLI:

  1. Install the Codex CLI.
  2. In Terminal, run codex login and sign in with ChatGPT. codex login status should say Logged in using ChatGPT.
  3. Come back to Arx and pick ChatGPT for the chat.

Connect during setup

The welcome flow has a Connect your agent page. It lists Claude and ChatGPT with what Arx found on this Mac:

  • Signed in: the app is installed and signed in with your plan. Click Connect to make it the assistant in every profile.
  • Not set up: the app isn't installed, nobody is signed in, or it's signed in with an API key. The row says what to do.
  • Needs a paid plan: the app is signed in on a free plan.

Sign in from Terminal while the page is open, then come back: Arx checks again by itself, or click Check Again. Later moves on without changing anything. Open the page again from Settings → General, or change the provider any time in Settings → Assistant.

Chats count against your plan's usage, the same as using Claude or ChatGPT yourself. If the app is signed in with an API key or a cloud provider instead of your plan, Arx doesn't use it and tells you so.

Start a chat

  • Text + Tab. In the command bar (⌘T, ⌘L or ⌘K), type anything and press Tab. The command bar closes and a new chat starts with what you typed. While Tab would start a chat, the right end of the field shows Ask an agent Tab; clicking it does the same as pressing Tab. It stays in the field rather than among the results, so a long list of suggestions never pushes it out of sight. It isn't there for an empty field, a search keyword, a !bang or the unchanged address ⌘L shows.
  • A search keyword stays a search. A search shortcut's keyword followed by Tab still starts a site search, and !bangs work as before. See Search and bangs.
  • The Chats command shows or hides the panel. Find it in the command bar or under Window → Chats.
  • A suggestion. A new chat lists up to three suggested prompts under Suggestions, just above the message box, about the tab you're on; the first is in your accent color, and every row has a › at its right edge. They're built from the page's title and site, such as "Summarize “Raycast for iOS” in a few points" or "What are the key takeaways from raycast.com?". Clicking one attaches that tab and sends the prompt. In Split View that's the pane you last clicked or moved to with the keyboard, at the moment you click, so the assistant never reads the pane you left; a chat pinned to a tab always asks about its own tab. Pages that aren't on the web, such as a new tab, get no suggestions.

Private windows have no chat.

The chat panel

The panel is a card beside the page, in your window's tint and film grain. It's quiet and tactile: every button is a glassy rounded square, and related buttons share one.

  • Your Chats (☰, top left) opens your list of chats.
  • The title, in the middle, shows the chat's name with the provider and model under it. Click it for Chat Info: the assistant's face with the chat's title, its provider and when it started, then Pin, Copy Answer and Archive, and a list of the chat's Provider, when it Started, how many Messages it has and whether it's kept (Pinned, Temporary or Archived). The note under the list says when a temporary chat disappears. ‹ goes back to the chat. Claude shows ✳︎.
  • ⋯ has Copy Answer, Pin Chat, Rename Chat…, Archive…, Delete Chat…, New Chat, Your Chats, Pin to This Tab, Open in Tab and Hide Chat. Type to filter it, use the arrows and press Return.
  • × hides the panel. A running answer keeps going while the panel is hidden, and even if you close the window. ⋯ and × share one tile with equal square buttons.

Resize the panel by dragging its left edge. It stays between 300 and 720 points wide and never squeezes the page below 360 points. Double-click the edge to go back to the standard width. Each window remembers its own width, and new windows start at the standard width.

Your messages sit on raised cards on the right. Answers are formatted: headings, bold and italic text, lists (nested, numbered or with checkboxes), quotes, links, code, and tables. A code block shows its language and a copy button. A table keeps its header and column alignment; when it's wider than the panel, scroll it sideways. While an answer is still coming, half-written formatting shows as it will look when it's done, and a table appears once its header is complete. Hold the pointer over a finished answer for its copy button, which copies the answer as Markdown; select text to copy just what you see. Images in an answer show their description and are never loaded. While the assistant works, a small tinted chip above the answer says which browser tool it's using, such as Using page snapshot, and then what it used; it turns orange when a tool didn't work. Thinking… shows under an answer that's still coming.

A new chat stays empty down to Suggestions and Recent Chats, your three latest chats, just above the message box.

The message box is a raised card, a little see-through: once a chat has messages, the conversation scrolls under it and stays visible through it, softly blurred, and under the bar at the top it blurs out softly, with no line. It says Message the assistant… in a new chat and Ask a follow-up… after that. It grows with your message, up to about ten lines, and then scrolls. Under the text are + for context, the model, and the send button; Stop takes its place while an answer is coming.

In a wide chat tab, the conversation and the message box stay at a comfortable reading width, centered in the tab. The model button chooses the model for this chat; Default uses the provider's own default. In a new chat it also lets you switch between Claude and ChatGPT. Before your first message, a line under the box says the chat counts against your plan.

Send⌘Return
New line⇧Return
Send or new line (Settings → Assistant)Return
Hide the chat panel⇧Esc

What Return does on its own is up to you, under Return key in Settings → Assistant:

  • Send (the default) sends the message.
  • New line starts a new line; send with ⌘Return.
  • Send one-liners sends while the message is one line, and starts a new line once it has several.

⇧Return always starts a new line and ⌘Return always sends.

⇧Esc hides the panel, whether it shows the global chat or a pinned one. It does nothing in a chat tab.

If an answer can't finish, the chat says why under your message: for example, you're signed out of Claude Code or Codex, you've reached your plan's usage limit, or the request needs more steps than the assistant takes. If nothing comes back for three minutes, the chat stops waiting and says so. Your message stays in the chat, and Try Again sends it again.

Where chats live

Widen the chat panel, pin the chat to this tab (another tab gets a new chat, and the pinned one comes back), open it in a tab, split it with the page, then move it back to the side.

Each window has a global chat. The panel shows it whichever tab you're on, so switching tabs doesn't change the chat. A new tab gets the global chat too.

Pin a chat to a tab

Choose Pin to This Tab in ⋯, or Pin Chat to This Tab in the command bar or the Window menu, to tie the chat to the tab you're on. The panel's global chat starts a new chat, and the pinned one stays with the tab:

  • Switching to that tab shows its pinned chat. Switching to any other tab shows the global chat again.
  • Showing the chat (the Chats command or Tab from the command bar) on a pinned tab shows the pinned chat.
  • The header shows a pin button while the panel shows a pinned chat. Click it, or choose Unpin from This Tab in ⋯, to unpin: the chat becomes the window's global chat again. Pin Chat to This Tab in the command bar also unpins when the tab already has a chat.
  • Picking another chat in Your Chats, or starting a new one, on a pinned tab pins that chat instead.
  • Closing the tab unpins the chat. The chat itself stays in Your Chats.

Pins belong to the window and are restored with it. Pin Chat (keeping a temporary chat) is a different thing and works as before.

Open a chat in a tab

Choose Open in Tab in ⋯, or Open Chat in Tab in the command bar or the Window menu, to turn the chat into a tab of its own. The chat moves out of the panel, the panel closes, and the tab opens in the current space:

  • It takes the full width of the page and its sidebar row shows the chat's title with the assistant's face. The title follows the chat when you rename it.
  • An answer keeps coming when you switch to another tab.
  • It's a tab like any other: drag it into Split View next to a page, move it, archive it or close it. Dragged onto the page's edge right after it opens, it splits with the page it replaced. Closing it closes the tab, not the chat; the chat stays in Your Chats.
  • Move to Sidebar in ⋯ closes the tab and shows its chat in the window's panel as the global chat.
  • A chat tab has no × and ⇧Esc does nothing in it. The Chats command still shows the window's panel beside it, with the global chat. A chat tab can't have a chat pinned to it.

Chat tabs belong to the profile, like every tab, and are restored with your tabs.

Give it context

Typing never sends a page to the assistant. To share one, press + in the message box. The menu starts with a search; type to filter, or use the arrows and Return. It lists This Tab, then Folders and Tabs of the profile, each tab with its site's icon. Arx sends the tab's title and address.

Files, images and captures

Drag an image from Finder onto the chat, paste a screenshot with ⌘V, and add a capture of part of the page with +. Remove one with its ×, then send them with your question.

You can attach images, PDFs and text files (such as Markdown, code or CSV) to a message:

  • Drag them onto the chat panel.
  • Paste an image or a copied file into the message box with ⌘V.
  • Press + and choose Files….
  • Press + and choose Capture Visible Area or Capture Area…. Arx captures the page beside the chat, the same way as File → Capture Area…, and attaches it as soon as it's taken.
  • After any page capture, choose Send to Chat in the menu beside the frame.

Images show as thumbnails above your message and files as their icon and name; each has an × to remove it before you send. Tabs show their site's icon.

Arx sends images to Claude and ChatGPT as images, so the model sees them. PDFs go to Claude as documents; ChatGPT gets their text. Text files are part of the message. Large images are scaled down first. Each provider takes a limited number and size of files in one message (Claude: up to 10 files and 5 MB per image; ChatGPT: up to 10 files), and the message box says when something is too large, too many, or a kind of file the assistant can't read. Captures don't work in private windows, which have no chat.

The assistant can read pages, take screenshots and act in your tabs only through Arx's own browser tools, with the same checks as any assistant connected through MCP. The first time, the panel asks you to Allow it for the profile. That adds a client named Arx Assistant for the profile under Settings → Advanced → Local assistants (MCP), which can see the profile's tabs, read page text and take screenshots, and asks you before any change. Change or remove its grants there like any other client. Allow turns on the local MCP server if it's off.

Pages can contain text written to mislead an assistant. Arx tells the assistant to treat page content as untrusted, and anything that changes your tabs still goes through your approval.

How long chats stay

By default chats are temporary: a chat disappears 20 minutes after its last message, or when you quit Arx, along with what Claude Code kept on your Mac for it. A crash doesn't leave them behind either; Arx cleans up the next time it opens.

  • Pin a chat to keep it. Unpin makes it temporary again.
  • To keep every new chat, set Keep chats to Until I delete them in Settings → Assistant.
  • Archive moves a kept chat out of Your Chats' main list; find it under Archived.
  • Delete removes a chat right away.

Your Chats

Your Chats shows your kept chats and the temporary ones still open, grouped by Today, Previous 7 Days, Previous 30 Days and then by month. Each row has the chat's title, its provider, Pinned if you pinned it, the latest answer and the time. Search by title or answer in the field under the header. The switcher on the right picks All, Unread or Archived; the chosen one sits in a darker square, and resting the pointer on one shows its name under it. ‹ goes back to the chat and + starts a new one. A chat that got an answer while you were elsewhere is marked unread with a dot.

Settings

Settings → Assistant has, from the top:

  • AI Commands, which opens a page of its own. AI commands aren't available yet; the page says they're coming.
  • Providers: Claude, through Claude Code, and ChatGPT, through Codex. A green dot means you're signed in, with the account and plan when the provider reports them; an orange dot means you're not signed in, or signed in in a way Arx doesn't use; a grey dot means the app isn't installed. Every profile uses the same connections.
  • Composer: Return key, which sets what Return does in the message box: Send, New line or Send one-liners. It applies to every profile.
  • Profiles: a section for each profile with its Default provider and Default model for new chats, and Keep chats: For 20 minutes (the default) or Until I delete them.

Each profile has its own chats, choices and Arx Assistant client. Nothing crosses between profiles.

Planned
Projects, which group chats with their own instructions, and chatting inline in the command bar are planned. So are AI commands (organizing today's tabs, tidying pinned-tab titles and downloaded filenames, summarizing links on hover, opening the top search result) and Assistant Features next to them (assistant search shortcuts, and turning on future assistant features automatically).