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.

Based on
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:

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
mobilefilesgitworkflows
Last updated: 2026-04-03