Use Wrangl on a phone

This works in a browser or on a phone only.

On a phone, Wrangl uses a layout made for a small touch screen. You see one chat, terminal or file at a time, and a menu slides in from the side for everything else.

Wrangl switches to this layout when the browser window is 767 pixels wide or less. It also uses it for a phone turned sideways, when the window is less than 500 pixels tall. A desktop browser window that you make narrow gets the same layout.

To make changes from your phone, the phone must be allowed to. A link shared from the desktop app is always view-only, and so is a server without --allow-remote-writes. See Allow changes from other devices.

Find your way around

A chat on a phone, with the menu button, the chat title, the project line, and the New chat and More buttons at the top

The bar at the top has these parts, from left to right:

Open menu (☰) opens the side menu.
The title of the chat or terminal. Under it is the project, the branch, and Local or Worktree. Tap that line to switch to another project.
A yellow number, when chats are waiting for you. Tap it to open the side menu.
New chat in a chat, or New terminal in a terminal.
More (⋯) in a chat, or Terminal actions (⋯) in a terminal.

Tap Open menu to see your chats, terminals and open files.

The side menu with the project at the top, the Chats, Terminals and Editors tabs, a chat search, recent chats, and the footer buttons

The picture was taken before the tabs became icons and the GitHub tab was added.

The project at the top. Tap it to switch projects.
Chats, Terminals, Editors and GitHub are four icon tabs that switch the list below. Chats shows a number when a chat waits for you. GitHub lists the project's issues and pull requests. See GitHub issues and pull requests.
Search chats… filters the chat list.
The list. Tap an item to open it.

The Chats list shows the chats you have open under Active. Closed chats are under Today, Yesterday and Earlier, sorted by when you started them. Each row shows when the chat was started, such as a time for today, "Yesterday 14:05", or a date for older chats. Reopening a chat does not change its time or its place in the list.

The bottom of the side menu has these buttons:

Settings (gear) opens the app settings.
Snapshots (camera) opens your saved terminal layouts. See Terminals.
Git history (clock) opens the commit history of the project.
Automations opens the automations of the project. See Automations.
New chat, New terminal or Browse files, depending on the list you are on. The GitHub list has no button here.

In a chat, tap More (⋯) for the actions that don't fit in the top bar.

The More menu for a chat, with Git changes, Files, Command palette, New terminal, Project settings, Reload this chat and Close chat

Git changes opens the changed files and the commit form.
Files opens the file browser.
Command palette opens the command palette.
New terminal opens a terminal in the project.
Project settings opens the settings of this project.
Reload this chat restarts the chat on a new agent process.
Close chat closes the chat.

On other tabs, such as a file or git history, the last item is Close tab.

Write a message

The message box at the bottom of a chat has four controls: +, the model pill, the context ring, and send. The model pill shows the agent's icon and the model name. In a new chat, the row has +, the model pill and send.

Tap anywhere in the message box to type.

Pick a model

Tap the model pill to open Select model:

Provider at the top shows the current agent. Tap it to see all agents, with a search box, grouped into Ready, Needs setup and Install. Tap an agent to see its models. An agent under Needs setup is set up in the sheet: Wrangl saves it, starts it, and asks you to sign in when the agent needs it. You don't have to open Settings.
The agent's models, with a short description. Tap the star of a model to add it to your favorites on this device.
Effort, Mode, Fast and the agent's other options.
Usage shows your Claude account's 5-hour usage.

Tap the back button or use the phone's Back to leave a sub-list.

Add to the chat

Tap + to open Add to chat:

Camera, Photos and Files attach a picture or a file. Camera and Photos are off when the agent can't take images.
Mention a file adds a file from the project.
Commands opens the agent's commands and skills.
MCP servers shows how many servers are on, and lets you turn them on or off.

Answer an approval

When an agent asks for permission, the chat shows Approval needed above the message box. The agent waits until you answer.

An Approval needed card on a phone with Allow, Always allow and Reject buttons

Tap one of the buttons. The agent decides which buttons you get. They are often Allow, Always allow and Reject.

For a short moment after the card appears, Wrangl ignores taps on it. This stops a tap meant for something else from approving by accident.

If a chat in the background needs you, the top bar shows a yellow number. Open the side menu. Chats shows the same number, and the chat that waits is in the list. To get a notification instead, see Get notifications.

Use a terminal

To open a terminal, tap New terminal in the top bar of a terminal, in the More menu, or at the bottom of the Terminals list.

A terminal on a phone with the key bar at the bottom: Paste, Esc, Tab, Ctrl+C, the arrow keys, PgUp and PgDn

A phone keyboard has no Esc, Tab or arrow keys, so Wrangl adds a key bar under the terminal:

Paste pastes the text from your clipboard.
Esc, Tab and Ctrl+C send those keys. Ctrl+C stops the running command.
The four arrows move the cursor or walk through your command history.
PgUp and PgDn scroll programs that use those keys.

The keyboard button at the left of the key bar hides the keys. Tap it again to show them.

Tap Terminal actions (⋯) for more:

Rename terminal.
Restart terminal.
Command history to find and run an earlier command.
Git changes, Files, Command palette and Project settings, as in the More menu.
Close terminal.

Browse and edit files

Tap More, then Files. You can also tap Browse files at the bottom of the Editors list.

The file browser on a phone showing the folders and files of the acme-shop project

Tap a folder to open it. Tap the back arrow to go up.
Tap a file to open it in the editor. The editor has a Save button.
The buttons at the top refresh the folder and create a New file or a New folder.
Tap ⋯ next to an item to Rename, Duplicate or Delete it.

Files you opened are in the Editors list of the side menu.

Commit your changes

Tap More, then Git changes.

The Git changes panel on a phone with two changed files, the Summary and Description fields, and the Commit to main button

Tap + next to a file to stage it, or + next to CHANGES to stage all files.
Tap the round arrow next to a file to discard its changes.
Tap the branch name at the top to switch branches.
Type a Summary, and a Description if you want, then tap the commit button.

For more about git in Wrangl, see Git.