Tips

Farero shows these tips under its loading spinners.

Search and commands

Press ⌘K to search chats, files and actions. Press ⇧⌘K to search actions only.
Start a search with @ to find files only, or with > to find actions only.
Start a search with me: to find your own messages, or with agent: to find the replies of the agent.
Add workspace:, branch: or pr: to a search to look in one workspace, branch or pull request. Put quotes around a value with spaces.
Choose Recent above the search results to see the newest matches first.
Open Workspace history in the command palette to find and restore an archived workspace.
Search the command palette for Open in to open the workspace in your editor, terminal or file manager.
Search the command palette for Theme, Sort by or Group by to change the view without opening Settings.
Press ⌥↓ to go to the next workspace and ⌥↑ to go back. On a Mac, also hold ⌘.

Chats

Press ⌘F to find text in the current chat.
Select text in a reply and choose Quote in reply to quote it in your next message.
Right-click an image in a chat and choose Copy image to copy it.
Press Fork to continue a conversation in a new chat. Choose To new workspace in the Fork menu to give that chat its own worktree.
When you fork to a new workspace, turn off With code to start from the base branch without the current changes.
In a new chat, pick earlier chats under Add a transcript from to give the agent their history.
Press Compact when a chat gets long. Your next message then starts with fresh context.
Open Outputs to see the images, diagrams, attachments, links and file references of a chat in one list.
Set Grouping to Tools in Settings › Interface to group tool calls and show the thinking of the agent as messages.
Set Steps summary to Latest step in Settings › Interface to show only the newest step of each group.
Change Message width and Message alignment in Settings › Interface to fit chats to your screen.
Open a diagram in full screen to zoom and pan it. Use Export diagram to save it.
Press Cancel on the questions of an agent to skip them and write your own message.
Choose General chat in New chat or workspace to start a chat with no repository or setup.
Choose Icon and color… in the menu of a general chat to make it easy to find in the sidebar.
Turn on Show link icons in Settings › Interface to see the icon of each site before its link in a chat.
Press Explore table in the header of a table in a chat to sort, filter and copy its rows.

Composer

Open the menu beside Send to send now, queue the message after the current turn or send it later.
⌘-click Send to do the opposite action: queue instead of send, or send instead of queue.
On a phone, long-press Send to do the opposite action: queue instead of send, or send instead of queue.
Queued messages wait under Up next. Edit one to move it back into the composer.
Choose Send later to send a message in an hour, tomorrow at 9:00 or next Monday at 9:00.
Type /btw and a question to ask the agent something while it works. The turn does not stop, and the answer changes no files.
Press ⇧⌘V to paste exact text into the message. A normal paste moves long text to an attachment and turns formatted text into Markdown.
Paste formatted text from a web page or a document. The composer keeps its headings, lists, links and tables as Markdown.

Tabs and split view

Press ⌘T to open a new chat in the same workspace.
Press ⇧⌘T to open the tab that you closed last.
Press ⌃Tab to go to the next chat tab and ⌃⇧Tab to go back.
Drag a tab to the left or right side of the chat and drop it to see two chats side by side.
In split view, point to the divider and press Swap panes to switch the two sides.
Double-click the split divider to make the two panes the same width. Focus the divider and use the arrow keys to move it.
Right-click a tab to rename it, pin it or mark it unread.
Drag a link from a chat to the tab bar and drop it on Drop to pin. The page then stays open as a pinned tab.
Right-click a link in a chat to open it in Farero, in split view or as a pinned tab.
Turn on Open external links in preview in Settings to read linked pages inside Farero.
Set Context usage in the tab settings to Ring, Donut, Percent or Underline to see how full the context of each chat is.

Workspaces

Right-click a workspace in the sidebar to rename it, set its status, pin it, mark it unread or archive it.
Choose Pin to top in the menu of a workspace to keep it above the others.
⌘-click workspaces in the sidebar to select several. Then set their status or archive them together.
On a phone, long-press a workspace to select it. Tap more workspaces, then set their status or archive them together.
A workspace shows In review while its pull request is open and Done after the pull request merges.
Press a status dot in Settings to give that status its own color.
Make any status the default in Settings. New workspaces start in the default status.
Turn on Name workspaces by their pull request title in Settings › Interface to see PR titles in the sidebar.
Set Model display in Settings › Interface to show the model a workspace started with, or the model its active chat uses now.
Turn on Delete merged branches on archive in Settings to remove the branch of a merged workspace when you archive it.
Press View options in the sidebar to group workspaces or to show only some repositories and statuses.
Choose Workspace config in the menu of a workspace and copy the setup prompt. Send it to an agent, and the agent writes the run settings.
Press ⌘N to start a new chat or workspace.

Review and Git

Press ⌘D to show or hide the changes panel.
Press Create PR on the merge banner to ask the agent for a pull request. The button changes to Update PR when the pull request exists.
⌘-click Create PR to queue the request after the current turn.
On a phone, long-press Create PR to queue the request after the current turn.
After a pull request merges, press Continue to keep the same chats on a new branch.
Press the commit count in the changes panel to see the changes from one commit only.
Right-click a file in the changes panel to copy its diff, add it to your prompt or discard its changes.
Right-click a folder in the file tree to expand or collapse all the folders inside it.
Choose Edit file in a diff to change the file in place.
Use Preview Markdown in a file view to see the formatted file. SVG, HTML, JSON, Mermaid and D2 files have the same preview.
On the computer that runs Farero, double-click a file in the changes panel to open it in its default app.
Use the arrow keys to move through the file tree.
Open a PDF, video or audio file from the file tree to view or play it in Farero.

Run and preview

Turn on Auto-open on start in the preview settings to see your app as soon as its dev server starts.
On the computer that runs Farero, press Run in terminal on a shell command in a chat to paste it into your terminal app.

Agents and models

Press ⌘M to open the model menu.
Star a model in the model menu to keep it at the top of the list.
Press Model settings in the model menu to open the settings for that model.
Add a role from the Role library in Settings › Agents. A role gives an agent its own instructions and model.
Turn on Automatically try other accounts in Settings › Agents. A chat then moves to another account when one account reaches its usage limit.
Press ⌘U to see the Plan usage of your provider accounts.
Press ⇧⌘U to see what fills the context of the current chat.
Find a role at farero.ai/roles/ and press Add to Farero. In the browser app, paste its link in Settings › Agents › Import from link.
Add Usage fallbacks to a role in Settings › Agents. The role then moves to the next model when it reaches a usage limit.

Phone and remote access

Open Connect a device in the command palette to use Farero on your phone.
Turn on Notifications in Settings on your phone to get alerts from your agents.
If Farero runs on a Mac, turn on Keep the Mac awake in Settings. Your agents then keep working while you are away from the Mac.

Appearance

Press Control-Z on a Mac or Alt+Z on other computers to enter Zen mode.
Set Artwork shuffle in Settings › Theme to change the Zen mode artwork every 10 or 30 seconds.
⌘-click a palette or an artwork in Settings › Theme to set it for the other mode, light or dark.
On a phone, long-press a palette or an artwork in Settings › Theme to set it for the other mode, light or dark.
Pick one tab spinner in Settings › Interface to use it on every tab, or choose Random to give each tab its own.

Farero Desktop

In the Farero Desktop browser, use Add page to chat or Screenshot to chat to show a page to the agent.
In the Farero Desktop browser, use Comment on element to pick a part of the page and ask the agent about it.
Use Inspect page in the Farero Desktop browser to open the developer tools.
Turn on Use browser cookies in inline previews to see previews of pages where you are signed in.