A Linux computer that lives on your Android phone.
Use it yourself, or give tasks to an agent working inside the same machine.

Box boots a persistent Debian VM directly on your phone.

Open the computer and use it like a normal desktop with a keyboard and mouse. Or start a task and chat with an agent that can use the same machine, files and tools for you.

No cloud VM. The computer is on the device in your hand.

I built Box around the setup I want when I travel: a Galaxy Z Fold 7, DeX, a portable monitor or display glasses, and a small keyboard and mouse.

Box can sit in one DeX window as a full Linux computer.

If I don't have another display, I can use the same computer on the Fold's inner screen or even the cover screen.

Same box. Same files. Different screen.

With a keyboard and mouse attached, Box behaves like a desktop.

Without them, the screen becomes a trackpad:

• drag to move the pointer
• tap to click
• two-finger tap to right-click
• two-finger drag to scroll
• tap and drag to drag

Box also has its own desktop keyboard for keys that matter in Linux: Ctrl, Alt, Super, Escape, function keys and the rest.

Plug a keyboard or mouse in and use it directly.

Tasks are conversations with an agent that has access to the same computer.

The first time Box opens it offers one thing to say — "Show me what's inside the box" — and answers it by doing the work: the agent reads the machine it is running on, tells you what it found, asks what you would like it to build, and builds it. Nothing about that reply is scripted. It is the same agent you get afterwards, working for the first time.

Ask it to clone a repo, fix something, run tests, work on a feature, review code, or prepare a PR. It can even work on Box itself.

The useful part is that this is not a disposable remote sandbox. The agent works inside your box, with the same persistent /workspace you can open yourself.

You can start something with the agent, open the desktop and inspect it, take over with the mouse and keyboard, then hand it back.

Commands, diffs and permission requests stay visible in the conversation. If you want the actual computer, open it.

The main cost today is performance: the stock runtime is fully emulated ARM64, so the first boot takes a couple of minutes on a Galaxy Z Fold 7.

The latest release has a prebuilt APK:

adb install -r box-*-stock.apk

For a plugged-in ARM64 Android phone, build the guest image and app:

./tools/deploy.sh --image

After the guest image exists:

./tools/deploy.sh

Use --image again when something under guest/ changes.

Run the tests with:

./gradlew :app:testStockDebugUnitTest :runtime-qemu:testDebugUnitTest \
  && node --test guest/tests/*.mjs \
  && python3 -m unittest discover -s guest/tests

More development notes are in docs/development.md.

stock is the product build and carries the QEMU guest image. The avf flavor is kept for app/UI work without bundling the guest image; Android does not expose hardware virtualization to third-party apps.