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 I never leave reviews, but for this I am. Paseo is clean it just works, you can chat with multiple agents at a time, you can direct while you are not home. It’s just amazing and very smooth. Interface is amazing too. I see no major issue so far, and the ones I do see the owner has already said they’re working on them.
I never leave reviews, but for this I am. Paseo is clean it just works, you can chat with multiple agents at a time, you can direct while you are not home. It’s just amazing and very smooth. Interface is amazing too. I see no major issue so far, and the ones I do see the owner has already said they’re working on them.
Beautiful app! The CLI installation is also very straightforward. It's just a bit of a pity that it can't read Codex conversation history and doesn't support the /resume command.
Beautiful app! The CLI installation is also very straightforward. It's just a bit of a pity that it can't read Codex conversation history and doesn't support the /resume command.
it's coming!
The most convenient tool currently in use is supported by both mobile phones and computers, and Claude and Codex can be switched at will.
The most convenient tool currently in use is supported by both mobile phones and computers, and Claude and Codex can be switched at will.
I would wish better selection for copy. And less screen freeze
I would wish better selection for copy. And less screen freeze
Bug fixes and improvements.
0.1.70 1h ago
Lots of fixes!
0.1.66 5d ago
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 Apr 29
Faster workspace loading
0.1.62 Apr 23
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 Apr 22
Markdown rendering performance improvements
Fix iPad buttons
0.1.56 Apr 14
Fix broken model selector for iPad
Themes
0.1.52 Apr 10
Better provider diagnostic and context window meter
0.1.50 Apr 8
Fix model selection
0.1.49 Apr 6
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 Apr 6
Support for Pi and Copilot.
0.1.47 Apr 6
New model picker
0.1.43 Apr 3
Layout fixes for iPad
0.1.40 Apr 1
fix hang after changing thinking
0.1.39 Mar 31
Performance improvements
0.1.35 Mar 27
0.1.34 - 2026-03-25
Added
Added paseo archive as a top-level alias for paseo agent archive.
Added the PASEO_AGENT_ID environment variable for Claude and Codex agents.
Added a redesigned command autocomplete with a detail card and dropdown styling.
Linked Android download surfaces to the Google Play Store.
Improved
Autonomous turns now complete gracefully on interrupt instead of being canceled.
Thinking/model selection now always resolves to a real option instead of showing a generic Default choice.
Restored per-provider form preferences and removed the Auto model fallback.
Improved Codex activity logs with clearer tool-call summaries.
Reduced unnecessary re-renders in the agent panel and input area for smoother interaction.
Improved chat transcript readability.
Fixed
Fixed paseo send --no-wait not taking effect.
Fixed stale abort results contaminating replacement turns after an interrupt.
Fixed Claude interrupt handling and autonomous wake reliability.
Fixed nested Claude Code session detection and provider availability checks.
Fixed agent input focus scoping across panels.
Fixed terminal snapshot ordering when subscribing.
Fixed chat read --since to accept message IDs.
Fixed keyboard pane focus syncing with the active panel.
Fixed assistant text selection on web.
Fixed archived-agent notifications still appearing in chat rooms.
Fixed the attach-images button interaction in the message composer.
Pruned wrong-platform native binaries from Electron desktop builds.
0.1.34 Mar 25
- Create terminals
- Create worktrees
- Stability fixes
0.1.32 Mar 23
Added
Added OpenCode build and plan modes.
Added website landing pages for Claude Code, Codex, and OpenCode.
Improved
Improved the git action menu for more reliable repository actions.
Improved the mobile settings screen, workspace header actions, and welcome screen presentation.
Updated the website hero copy and added a sponsor callout section.
Fixed
Fixed assistant file links so they open the correct workspace files from chat.
0.1.28 Mar 15
- Tab management
- Workspace first navigation
- Improved terminal
0.1.26 Mar 12
Stability fixes.
0.1.16 Feb 23
Bug fixes and improvements.
more Version 0.1.70 1h ago
Data Not Collected The developer does not collect any data from this app.