Paseo - Claude Code & Codex
Remote Claude Code and Codex
Free · Designed for iPad. Not verified for macOS.
Run Claude Code, Codex, and OpenCode on your machine from your phone. Paseo is a self-hosted app that connects to your local dev environment so your agents run with full access to your actual setup - not a cloud sandbox.
Key features:
- Voice support: talk to your agents hands-free with on-device speech processing
- Multi-provider: use Claude Code, Codex, or OpenCode from one interface
- Git worktrees: agents work in isolated branches, review diffs and ship from the app
- Real-time streaming: live agent output and push notifications when tasks complete
- Self-hosted: runs on your laptop, home server, or VPS. Your code stays on your machine
- Remote access: optional end-to-end encrypted relay for connecting from anywhere
- Open source and free
Requires a running Paseo server on your machine. See paseo.sh/docs for setup.
more Bug fixes and improvements.
0.1.93 11 hr ago
Bug fixes and improvements.
0.1.91 2 days ago
Bug fixes and improvements.
0.1.90 6 days ago
Bug fixes and improvements.
0.1.89 2 Jun
Bug fixes and improvements.
0.1.88 1 Jun
Bug fixes and improvements.
0.1.86 29 May
Bug fixes and improvements.
0.1.83 26 May
Bug fixes and improvements.
0.1.81 25 May
Bug fixes and improvements.
0.1.80 21 May
Bug fixes and improvements.
0.1.78 18 May
Bug fixes and improvements.
0.1.75 15 May
Bug fixes and improvements.
0.1.74 12 May
Bug fixes and improvements.
0.1.73 11 May
Bug fixes and improvements.
0.1.70 9 May
Lots of fixes!
0.1.66 3 May
Added
Project settings page with a built-in paseo.json editor.
Cold start restores your last open workspace.
Tool call badges have a button to open the referenced file directly.
Open the current branch on GitHub from a workspace's open menu. (#583 by @Myriad-Dreamin)
Enable or disable providers from Settings without editing config files.
Paseo prompts you to configure a worktree setup script when one is missing.
Choose whether the daemon shuts down when you close the desktop app.
Improved
Provider settings and model selection have been redesigned.
Voice mode transcription endpoint is configurable for OpenAI-compatible providers. (#570 by @yuruiz)
Adding a project no longer waits for GitHub PR status to load.
Startup splash screen is cleaner — just the logo with a subtle shimmer.
paseo.json setup and teardown accept a single command string, not just an array.
Archiving a worktree is instant instead of waiting for the backend to confirm.
Agent timelines and git diff lists no longer jump around while loading or streaming.
Fixed
paseo loop run and paseo run now respect the --provider and --model flags. (#594 by @VincenzoRocchi)
Pi provider shows up when only DeepSeek or other non-OpenAI/Anthropic/OpenRouter API keys are set.
Custom models from additionalModels and profileModels are honored when picking a default for new agents.
File preview line numbers stay on one line past line 99.
Cmd+Q on macOS quits the desktop app instead of leaving it running in the background.
Terminal sessions recover cleanly after rendering hiccups, including the initial resize for nvim.
Terminal protocol query responses no longer leak into the browser.
Assistant link color matches the theme again.
File links with line numbers (like foo.ts:42) open correctly from assistant messages.
Claude's Grep results show up in the search detail body.
Reopening a worktree lands under the right project.
Agents from disabled or unavailable providers stay visible in history.
New CLI agents now require a provider instead of failing silently.
Git diff headers no longer truncate.
Provider diagnostic modal scrolls on short screens.
Provider diagnostics show the real error and underlying child-process output instead of a generic message.
Archived workspaces no longer interfere with working-directory resolution.
Triple-click on a message no longer extends the selection into adjacent bubbles.
The packaged desktop app preserves your zsh prompt.
0.1.63 29 Apr
Faster workspace loading
0.1.62 23 Apr
0.1.60 - 2026-04-22
Added
Scripts and services per worktree — define named commands in paseo.json, and long-running services get supervised with their own ports and nice proxy URLs like http://web.my-app.localhost:6767. See the worktrees guide.
Launch scripts and services for a worktree directly from the workspace header.
New Setup tab in every workspace showing setup, teardown, and script progress live.
GitHub checks and PR reviews in the explorer sidebar, with a hover card for the full breakdown.
New worktree creation flow lets you pick a base branch or check out an existing GitHub pull request.
Attach GitHub issues and pull requests to an agent as part of its prompt context.
Pull request pane in the workspace sidebar.
Redesigned Settings screen with modular section navigation.
Per-host provider configuration — set providers, models, and credentials independently on each remote host.
Direct Pi integration replaces the ACP bridge, with faster streaming and fewer hiccups.
Beta release channel — opt in from Settings to receive beta desktop builds before they are promoted to stable.
New-workspace picker ranks branches by recency with fast search.
Improved
Workspace and tab switching are dramatically faster on desktop and mobile — you can keep many workspaces open in parallel without lag.
Agent streams render more smoothly during heavy tool output.
App startup routes through a stable connection and lands on the right screen without flicker.
Provider refresh is reliable and no longer stalls on transient failures.
Git and GitHub state stay in sync with local changes like commits, branch switches, and pushes.
Composer attachments redesigned with a cleaner pill layout and an image lightbox.
In-app notifications route to whichever surface you're actually looking at.
Keyboard shortcuts keep working while Settings is open.
Escape reliably interrupts the active agent.
Checking out a pull request from a fork lands on an owner-prefixed branch so multiple forks don't collide.
paseo ls defaults to active agents; pass -a to include archived.
GitHub branch and PR picker loads faster — queries are deferred until the picker opens.
Fixed
Composer textarea shrinks back down after sending on web.
New workspace drafts clear after submit instead of sticking around.
Replacing a running agent cleans up the previous one without leaving it behind.
Agent notifications no longer get swallowed by a backgrounded focused client.
Removed workspace folders disappear from the workspace list again.
Codex keeps fast mode after you approve a plan. (#526 by @therainisme)
Workspace tab focus is preserved across page refreshes.
Settings screen no longer pushes its header down with extra spacing.
Branch switcher title no longer overflows on narrow rows.
iOS image picker no longer leaves the screen unresponsive after cancelling.
Archiving a worktree recovers cleanly if a previous attempt was interrupted.
Images in agent messages with ~-prefixed paths load instead of spinning forever.
Tool call blocks expand correctly on mobile while an agent is still streaming.
Timeline no longer stutters when catch-up and projected ranges overlap.
Codex no longer flashes idle when a replacement turn is in progress.
Branch state recovers correctly when a rebase is in progress.
Workspace hover card no longer clips near screen edges.
0.1.60 22 Apr
Markdown rendering performance improvements
Fix iPad buttons
0.1.56 14 Apr
Fix broken model selector for iPad
Themes
0.1.52 10 Apr
Better provider diagnostic and context window meter
0.1.50 8 Apr
Fix model selection
0.1.49 6 Apr
Added
Provider diagnostics — tap a provider in Settings to see binary path, version, model count, and status at a glance. Helps troubleshoot why an agent type isn't available.
Provider snapshot system — daemon now pushes real-time provider availability and model lists to the app, replacing the old poll-based approach. Models and modes update live as providers come online or go offline.
Codex question handling — Codex agents can now ask the user questions mid-session (e.g. "which file?") and receive answers inline, matching the Claude Code question flow.
Reload tab action — right-click a workspace tab to reload its agent list without restarting the app.
Improved
Model selector redesigned — grouped by provider with status badges, search, and better touch targets on mobile.
Enter key now submits question card answers and confirms dictation, matching the expected keyboard flow.
Removed noisy agent lifecycle toasts that fired on every state change.
Fixed
Desktop app now resolves the user's full login shell environment at startup, fixing tools like codex, node, bun, and direnv not being found when Paseo is launched from Finder or Dock. Terminals spawned by Paseo now inherit the same PATH and environment variables as a normal terminal session. Approach adapted from VS Code's battle-tested shell environment resolution.
Input field on running agent screens now correctly receives keyboard focus.
Mobile model selector alignment and sizing.
0.1.48 6 Apr
Support for Pi and Copilot.
0.1.47 6 Apr
New model picker
0.1.43 3 Apr
Bug fixes and improvements.
more Version 0.1.93 11 hr ago
Data Not Collected The developer does not collect any data from this app.
