How to edit files from your phone while Claude Code or Codex is running
Make small fixes (and avoid “I’ll fix it later”) by editing real workspace files from mobile while Claude Code / Codex keeps running on your machine.
- CLI
- 0.1.0
- Preview ref
- f36aa45
I kept hitting a small-but-annoying problem (and it adds up):
An agent is running (Claude Code or Codex). I’m on my phone. I notice a tiny fix that would make the run cleaner:
- a config value is wrong,
- a file needs to be renamed,
- there’s a stray log line,
- or the agent created a file in the wrong directory.
If I ignore it, I usually pay later (bigger diff, messier commit).
If I SSH in from my phone, I can fix it — but it turns into doing terminal work on mobile.
So I wanted a workflow that lets me make small workspace edits from my phone while the session keeps running on my machine.
TL;DR
- Use Files to browse/search and open a file in edit mode.
- Make the small fix.
- Use Review / tool timeline to sanity-check what changed.
- If you’re going to commit from your phone, enable Git operations; otherwise commit later.
What I mean by “edit files from your phone”
I don’t mean editing a copy of your repo in the cloud.
I mean:
- the repo lives on your laptop/server/dev box
- your phone is where you open real workspace files and make small changes
- Git still runs where the repo lives
What I tried first (and where I bounced off)
-
SSH from my phone: it works, but for anything diff-shaped (reviewing, staging, making sure you didn’t touch the wrong file) it’s easy to rush.
-
Remote desktop: works, but it’s heavy and fiddly for quick edits.
-
Happier: gives me a repo-aware Files surface and an editor in the session UI, so I can make small changes without leaving the session context. Trade-off: it still depends on the machine/daemon being reachable; and for bigger refactors I still prefer a full keyboard.
If you’re new to Happier (what it is, and where to get it)
If you haven’t seen Happier before: it’s an open-source companion app (mobile/web/desktop) for AI coding agents like Claude Code, Codex, and OpenCode.
The session still runs on a machine you trust (laptop/server/dev box). Happier is where you monitor, steer, approve, review, and keep going from your phone.
Get set up:
- How to run Happier from your phone
- GitHub: https://github.com/happier-dev/happier
- Install/download: https://github.com/happier-dev/happier#how-it-works
- Discord (community + support): https://discord.gg/W6Pb8KuHfg
Prerequisites
- The session’s owning machine/daemon is online and reachable.
- You have access to the repo/workspace from the session.
Step-by-step: edit a file from your phone
1) Open Files
In the session UI, open Files.
On a phone-sized layout, this is a full-screen flow rather than a sidebar + details pane.
2) Find the file
Use one of these:
- browse the tree
- use search when you know the name
- use the modified-only filter when you want to focus on what changed
3) Open the file in edit mode
Open the file, then switch into edit mode.
Make the change.
4) Sanity-check what changed
Two ways I sanity-check from a phone:
- open Review to scan the uncommitted diff set
- use the tool timeline to see what edits happened (especially helpful if the agent is still running)
5) Decide whether to commit now or later
- If you’re already in “commit from phone” mode, you can stage + commit.
- If you’re just doing cleanup, it’s fine to leave it uncommitted and do the final commit later from a laptop.
Attachments vs workspace files (easy to mix up)
If your goal is “this should land in git,” you want to edit workspace files.
Attachments are great for sharing a log or an artifact with the model, but they’re not the same as editing the repo.
Troubleshooting
Symptom: Files is empty or won’t load
Likely cause:
- the owning machine/daemon isn’t reachable
Fix:
- restore connectivity; Files depends on machine workspace APIs
Symptom: I can browse files, but edits don’t persist
Likely cause:
- you’re editing an attachment or a preview surface, not the real workspace file
Fix:
- open the file from Files and ensure you’re in edit mode