Manage OpenCode Worktrees from Mobile
Use a worktree when you want an isolated project directory for a parallel change without disturbing the main working directory.
Create one
Section titled “Create one”- Open New chat.
- Choose the project that should own the worktree.
- Select New worktree and enter an optional name.
- Confirm.
The server decides the resulting directory and branch details. The app selects the new location and opens a chat there. Confirm the project and branch before starting work.
You can also select an existing worktree from the worktree switcher beside the project name in Projects, Chat, or New chat.
Remove one
Section titled “Remove one”- Open the worktree switcher.
- Enter its management mode.
- Choose Remove for the worktree.
- Confirm the destructive action.
Removal deletes the worktree managed by OpenCode. Check the displayed directory and branch and make sure any valuable work is committed or backed up first.
What is not available
Section titled “What is not available”- Reset to a server-defined starting state is not part of the current app.
- An optional start command when creating a worktree is not available.
- Worktree creation is a chat flow, not a separate Projects tab.
Worktree management relies on experimental OpenCode endpoints. Availability and behavior may change more frequently than core session functionality. If the worktree controls are missing, the connected server may not expose them.
Important limitation
Section titled “Important limitation”A worktree is still a server directory. It uses the same connection, providers, and permissions as the project that owns it. It is not a sandbox for untrusted code.
Next: Start a task in the intended project, work with files, or review permissions and changes.