CW-201a · Module 3

Desktop-First Workflows

4 min read

Good news, everyone! Claude Code is no longer just a terminal. The Desktop app turns it into a native development environment with visual capabilities that fundamentally change how you build frontend work. This is the part most people skip because they assume the Desktop app is a wrapper around the CLI. It is not. It is a different tool with a different superpower: it can see your application.

Server previews are the headline feature. Claude spins up your dev server, renders your application in an embedded preview, takes screenshots of the output, and iterates automatically based on what it sees. It reads console logs, catches runtime errors, and keeps refining until the visual output matches your specification. This is the screenshot loop — Claude writes code, previews the result, evaluates what it built, and fixes what does not match. For frontend work, this closes the gap between "the code compiles" and "the page looks right." A passing build tells you the syntax is correct. A screenshot tells you the layout is correct. Both checks matter, and the Desktop app runs both.

The Desktop app also handles pull request monitoring, and this is where things get fascinating. You open a pull request, and Claude tracks the CI pipeline in the background. When a check fails, Claude reads the failure, writes a fix, commits the change, and pushes it — all without interrupting whatever you are doing in your current session. With automerge enabled, the PR lands the moment all checks pass. You are already working on the next task while the previous one completes its review cycle. Local code review adds another layer: before your code reaches a human reviewer, Claude leaves inline comments on potential bugs, logic errors, and style violations. This is not a linter. It is a reviewer that understands the intent of your code and flags where the implementation diverges from that intent.

Session mobility means you are not locked to one device. Start a session in the Desktop app on your workstation, pick it up in the CLI when you SSH into a server, then check on progress from the mobile app while you are away from your desk. The session state persists across all three surfaces. Context is preserved. Work continues.

Git worktree support solves the parallel agent problem that has tripped people up since multi-agent workflows became practical. Each agent gets its own worktree — an isolated copy of the repository on a separate branch. Agent A refactors the authentication module on branch feature/auth while Agent B builds a new dashboard component on branch feature/dashboard. They never touch each other's files. They never create merge conflicts during execution. When both finish, you merge their branches through normal git workflow. This is the infrastructure that makes parallel development agents safe.

The worktree pattern also means you can keep working in your main branch while background agents handle tasks in their own branches. Your working directory stays clean. No stashed changes. No accidental commits to the wrong branch. Each agent operates in its own sandbox, and the sandbox is a real git worktree — not a simulation, not a copy, a proper git-managed isolated working directory.

Do This

  • Use Desktop for frontend and visual work — the screenshot loop catches layout bugs that passing builds miss
  • Use CLI for scripting, automation, and headless server tasks where visual preview adds no value
  • Use IDE integration for code-level editing where you need to read and navigate the codebase yourself
  • Enable worktree mode when running parallel agents so each gets an isolated branch

Avoid This

  • Use the CLI for frontend iteration — you lose the screenshot loop and have to check the browser manually
  • Use the Desktop app for simple one-off scripts — the CLI is faster for non-visual tasks
  • Run parallel agents on the same branch — they will create conflicting file changes and merge failures
  • Ignore session mobility — starting over in a new session wastes the context you already built