Troubleshooting

Answers and solutions to frequent problems in the ZeroTwo desktop app

Fixes for common desktop app problems.

Frequently Asked Questions

Files appear in the review panel that the agent didn't edit

The review tab can show the whole Git state of the repo. Open its scope menu and choose Last turn to see only the latest turn's changes; the other scopes are All uncommitted, Unstaged, Staged, Commit and Branch (review pane).

Remove a project from the sidebar

Open a local project's row menu and choose Remove project; the folder on disk is untouched. Re-add it with Add new project in the project picker. Cloud projects have Delete project in the same menu instead.

Find archived chats

They are under Settings. On the web look in Data Controls > Archived chats; the desktop app has an Archived tasks tab.

A Work conversation does not appear on another device

Chats are stored with your account, so sign in with the same account and workspace on every device. Local tasks run only on the desktop that started them, so a conversation you can see elsewhere may still need that computer to do any work.

A task cannot use my computer's files or tools

Local tasks use the files and tools of the desktop app that started them, so keep that computer awake and online (Prevent sleep while running in Settings > General helps). If it goes offline mid-task, the task pauses and picks back up when the desktop app is online again. On Ultra, Keep working in the cloud (Settings > General) moves an offline Code task to a cloud sandbox after about a minute. While the task runs, ZeroTwo keeps a copy of its Git repository in the cloud, so the sandbox starts from that copy, including uncommitted changes. It cannot see anything outside the copy, such as files outside the repository, files Git ignores or tools installed on your computer. Folders that are not Git repositories with commits, or are too large to copy, simply wait for the computer to return.

Only some chats appear in the sidebar

The sidebar loads more chats as you scroll. Use History options beside Recents to change how chats are organized or sorted, or press Mod+K to search every chat.

Code doesn't run on a worktree

A worktree is a fresh checkout, so files Git ignores, such as .env files and installed dependencies, are not there. Install dependencies and copy any local configuration into the new worktree, or ask the agent to do it (worktrees).

A feature is missing on the web

The Browser, Computer use, Computer history, Providers, Hooks, Connections, Git and Worktrees settings, along with the Code Review page, exist only in the desktop app. See Settings.

The desktop app has an update waiting

ZeroTwo checks for updates on launch and about every 15 minutes but never downloads one on its own. Choose the Download update to ZeroTwo entry (it names the version) in the sidebar, then restart when it says the update is ready, or use Check for Updates from the menu. Linux .deb installs do not update themselves.

Windows says it protected my PC

The installer is signed, but a new release may not yet have built reputation with SmartScreen. Choose More info and then Run anyway after confirming the publisher is ZeroTwo Innovations Inc.

Stuck states and recovery patterns

Check for a pending approval card in the chat, run git status in the integrated terminal, or start a fresh chat with a narrower prompt. The Stop button interrupts a run, and in Work and Code, typing a message while a run is active turns Stop into Steer by default, which sends the message into the current run. To queue follow-ups instead, change Follow-up behavior in Settings > General.

Terminal issues

If the terminal hangs, reopen it with Ctrl+`, confirm the directory and branch, and restart the app if needed. Code views share the Code font setting under Appearance in Settings.

A cloud environment allows network access but an action is blocked

Check the environment's internet access under Settings > Coding > Code Cloud. The modes are off, Package managers (the default), Custom domains only and All; with a custom list, the domain the command contacts must be on it. Changes apply after you publish the environment.