Edit files on your computer from your phone

A practical workflow to browse a repo, search files, make a precise edit, then review the diff and commit — all from your phone, without remote desktop.

Based on
CLI
0.1.0
Preview ref
b9e23d5

I don’t want to “develop on a phone.”

What I want is narrower:

  • fix one config value
  • tweak one line in a README
  • update a path
  • adjust a feature flag

…from my phone, while the repo stays on my computer.

Because the real pain isn’t typing.

It’s that the moment you leave your desk, file access turns into a mess of half-working options.

This guide is the workflow I use to make “one precise edit” from a phone feel safe.

The trade-offs (so you can pick your poison intentionally)

When people say “edit files remotely from iPhone”, they usually mean one of these:

  1. SSH + terminal editor (vim/nano)
  2. Remote desktop (screen sharing)
  3. Mount a remote folder into the iOS Files app
  4. Clone the repo onto the phone (a mobile Git client)

All of these can work.

The question is: which one fails least for your brain.

What I tried first (and where I bounced off)

  • SSH from my phone: technically fine, but it’s not a pleasant editing workflow. You end up doing real work in a tiny terminal.
  • Remote desktop: heavy and fiddly, especially on mobile networks. It’s a “break glass” tool, not a daily workflow.
  • Mounting folders into iOS Files: tempting, but brittle. It’s very easy to end up in weird states where hidden files, permissions, or tooling assumptions bite you.
  • A local mobile Git client: actually great if you want an iPad-first workflow. Working Copy is the canonical example on iOS.

But none of those options give me what I really want:

“I want my computer to remain the source of truth, and I want a clean phone UI for files + diffs + commits.”

A workflow that worked for me

I ended up using a “remote UI over my computer” approach.

Happier is one option that supports that approach.

It has a Projects tab where you can add folders from a connected computer and treat them as first-class projects — with:

  • a Files view (browse, search, download/upload)
  • a file editor (for small, precise edits)
  • a Source control view (diffs, commit, pull/push, history)

Trade-off: your computer still has to be online.

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) that lets you keep workflows on a computer you trust, then manage them from your phone.

Get set up:

Step-by-step: edit a file on your computer from your phone

1) Add the repo folder as a Project

  1. Open Projects.
  2. Tap ADD A PROJECT.
  3. Tap Choose a folder on your computer.
  4. In Select Path, navigate to the repo folder.
  5. Tap Use.

From here on, you’re working with a folder on your computer — not a copy on your phone.

2) Use Files as your “I just need the file” surface

Open the project, then open Files.

Three features matter for phone editing:

  • Search (so you don’t scroll trees)
  • Download/Upload (when you need to move something)
  • An editor that’s good enough for “one precise edit”

If you see a search bar labeled:

  • Search files…

…use it aggressively.

On a phone, navigation is the tax. Search is the refund.

3) Make the smallest possible edit

Open the file you want.

Do the smallest edit that moves the world forward.

Then hit:

  • Save

If you realize you’re going down a rabbit hole, hit:

  • Cancel

A good phone workflow is not “I can do everything.”

It’s “I can do the 10% that prevents stalls.”

4) Review what you changed (don’t trust your own memory)

After you save, switch to:

  • Source controlChanged files

Then:

  • tap ↓ Review

If the repo is large, you may see:

  • Large diff detected; diffs will load as you scroll.

That’s a clue to keep your edits small.

5) Decide: keep / revert / comment / commit

I try to make an explicit decision after each phone edit:

  • Keep it: it’s correct.
  • Revert it: I changed the wrong thing.
  • Leave a review comment: I want the agent (or future-me) to make a precise change later.
  • Commit it: it’s a self-contained improvement.

If you’re committing, you’ll see:

  • Commit message
  • Commit

Try to keep commits clear and honest.

6) Push (only when you’re confident)

In Source control, you can use:

  • Pull
  • Push

My rule:

  • pull whenever
  • push only after a quick diff review

If you see:

  • Operation requires a clean working tree.

…believe it.

It’s not a suggestion.

Practical examples (what I actually edit from a phone)

These are “good phone edits”:

  • update a feature flag / config constant
  • fix a broken link
  • adjust a version pin
  • edit one env var name
  • add a TODO that unblocks future work

These are “bad phone edits”:

  • large refactors
  • migrations
  • multi-file rename sweeps

Not because they’re impossible.

Because they’re too easy to get subtly wrong when you’re away from your normal tooling.

Terminal (optional)

Sometimes you really do need a terminal.

In Projects, you also have a fully-featured terminal accessible on the terminal icon in the project page header (on the right).

I treat it like a last resort:

  • use the UI for files + diffs + commits
  • use terminal only when you need a command the UI doesn’t expose

If you use terminal for everything, you’ve recreated the “SSH from a phone” problem.

FAQ

Should I just use a mobile Git client?

If you want the repo on your phone, yes.

A mobile Git client like Working Copy is great.

This guide is for “my repo lives on my computer; I just want remote edits + review.”

Does this replace an IDE?

No.

It replaces the panic moment:

“I need to change one thing right now, but I’m away from my desk.”

That’s a different job.

fileseditorgitmobileprojectsworkflows
Last updated: 2026-04-04