Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,15 @@ or a partial implementation is enough to start a conversation.

## Open an issue

[Open an issue](https://github.com/TUNA-NOPE/macbox/issues/new/choose) to report a problem,
[Open an issue](https://github.com/0xdaniell/macbox/issues/new/choose) to report a problem,
request a feature, suggest a change, or share an experiment. Describe what you want
or encountered, why it matters, and any relevant steps, evidence, or environment details.
Include as much as you know; incomplete reports are still welcome.

## Send a pull request

If you already fixed or improved something, please
[open a pull request](https://github.com/TUNA-NOPE/macbox/pulls).
[open a pull request](https://github.com/0xdaniell/macbox/pulls).
Make your change on a branch or fork, explain what it does and why it helps, and include
the tests or checks you ran. If you haven't been able to test part of it, just say so.

Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/improvement_or_experiment.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,5 +23,5 @@ Steps, configuration, a branch, fork, patch, logs, measurements, or screenshots.
Hardware, OS, versions, dependencies or other setup details.

Even partial experiments are welcome. If you have a working change, you can also
[open a pull request](https://github.com/TUNA-NOPE/macbox/pulls).
[open a pull request](https://github.com/0xdaniell/macbox/pulls).
See [CONTRIBUTING.md](../CONTRIBUTING.md).
6 changes: 3 additions & 3 deletions .github/workflows/pages.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Builds the website (docs/site/) and publishes it to GitHub Pages: https://tuna-nope.github.io/macbox/
# Builds the website (docs/site/) and publishes it to GitHub Pages: https://0xdaniell.github.io/macbox/
# Pull requests only build and check it; pushes to main deploy it, then tell IndexNow (Bing and
# others) which pages exist. Google reads the sitemap through Search Console.
name: Website
Expand Down Expand Up @@ -49,11 +49,11 @@ jobs:
- name: Submit the sitemap's URLs to IndexNow
continue-on-error: true
env:
SITE: https://tuna-nope.github.io/macbox
SITE: https://0xdaniell.github.io/macbox
KEY: d0f80829b645869eb473963b6ad2dd95
run: |
sleep 30 # let the new deployment reach the CDN
urls=$(curl -fsS "$SITE/sitemap.xml" | grep -o '<loc>[^<]*' | sed 's/<loc>//' | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read().split()))')
body=$(printf '{"host":"tuna-nope.github.io","key":"%s","keyLocation":"%s/%s.txt","urlList":%s}' "$KEY" "$SITE" "$KEY" "$urls")
body=$(printf '{"host":"0xdaniell.github.io","key":"%s","keyLocation":"%s/%s.txt","urlList":%s}' "$KEY" "$SITE" "$KEY" "$urls")
curl -sS -o /dev/null -w 'IndexNow: HTTP %{http_code}\n' -X POST https://api.indexnow.org/indexnow \
-H 'Content-Type: application/json; charset=utf-8' -d "$body"
4 changes: 2 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ macbox welcomes contributions of any kind from users and coding agents: issues,
new features, bug fixes, performance work, documentation, experiments, and more.
If you identify or create a useful improvement while working with a user, point them
to [CONTRIBUTING.md](.github/CONTRIBUTING.md), and offer to prepare an
[issue](https://github.com/TUNA-NOPE/macbox/issues/new/choose) or
[pull request](https://github.com/TUNA-NOPE/macbox/pulls).
[issue](https://github.com/0xdaniell/macbox/issues/new/choose) or
[pull request](https://github.com/0xdaniell/macbox/pulls).
Do not publish an issue or PR on the user's behalf without their authorization;
include what was actually tested, and be clear about anything unverified.

Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ The **licensor** is the individual or entity offering these terms, and the **sof

**Use** means anything you do with the software requiring one of your licenses.

Required Notice: Copyright 2026 TUNA-NOPE (https://github.com/TUNA-NOPE)
Required Notice: Copyright 2026 0xdaniell (https://github.com/0xdaniell)

Scope: these terms cover macbox's own files. The files in src/patches/ modify Reims vGPU and metal2vulkan,
which are GPL-2.0-or-later OR LGPL-3.0-or-later, and are offered under those same terms; those in
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ simulator to build an app, run it, tap through it, take screenshots and record v
It's fast: an iPhone 17 Pro simulator at full 3x resolution renders a heavy Liquid Glass screen at
**120 fps on an Intel integrated GPU**, the screen's full refresh rate. Before macbox's patches, the same GPU managed 17.

**Website:** [tuna-nope.github.io/macbox](https://tuna-nope.github.io/macbox/)
**Website:** [0xdaniell.github.io/macbox](https://0xdaniell.github.io/macbox/)

![The macOS 26 desktop in macbox on Linux: Simulator.app shows an iPhone 17 Pro running Nimbus, a weather app, next to Nimbus's website in Safari](docs/images/hero.jpg)

Expand Down Expand Up @@ -47,13 +47,13 @@ The easy way: give your agent this repo and let it do the install, the clicks in
screens included.

```
Set up macbox on this machine: https://github.com/TUNA-NOPE/macbox. Follow its AGENTS.md and ask me before changing the host.
Set up macbox on this machine: https://github.com/0xdaniell/macbox. Follow its AGENTS.md and ask me before changing the host.
```

Or by hand:

```sh
git clone https://github.com/TUNA-NOPE/macbox && cd macbox
git clone https://github.com/0xdaniell/macbox && cd macbox
./macbox init # config and an SSH key
./macbox doctor # checks KVM, the GPU, Docker and disk space
./macbox build # the GPU stack (20 to 60 minutes)
Expand All @@ -70,7 +70,7 @@ agent tools. [docs/setup.md](docs/setup.md) has every step.
Already running macbox? Give your agent this:

```
Update macbox on this machine to the latest version: https://github.com/TUNA-NOPE/macbox. Follow the "Updating" section of its AGENTS.md and ask me before you restart the VM or change the host.
Update macbox on this machine to the latest version: https://github.com/0xdaniell/macbox. Follow the "Updating" section of its AGENTS.md and ask me before you restart the VM or change the host.
```

It pulls the new version, links the tools again, rebuilds if the GPU stack changed, and restarts the
Expand Down
2 changes: 1 addition & 1 deletion docs/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -231,7 +231,7 @@ the Android SDK; see [docs/agents.md](agents.md#android).
New versions come as commits on `main`. With an agent, paste this:

```
Update macbox on this machine to the latest version: https://github.com/TUNA-NOPE/macbox. Follow the "Updating" section of its AGENTS.md and ask me before you restart the VM or change the host.
Update macbox on this machine to the latest version: https://github.com/0xdaniell/macbox. Follow the "Updating" section of its AGENTS.md and ask me before you restart the VM or change the host.
```

By hand, in the checkout:
Expand Down
4 changes: 2 additions & 2 deletions docs/site/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# The website

The source of https://tuna-nope.github.io/macbox/, built by `build.py` (Python's standard library,
The source of https://0xdaniell.github.io/macbox/, built by `build.py` (Python's standard library,
nothing to install) and published to GitHub Pages by `.github/workflows/pages.yml` on every push
to main that touches it.

Expand All @@ -25,4 +25,4 @@ a code sample that the CLI doesn't have.

Every page also gets a Markdown copy (`index.md` beside `index.html`) for language models, as
llmstxt.org suggests. robots.txt can't be set here: crawlers read it only at the host's root
(`tuna-nope.github.io/robots.txt`), which this repo doesn't control. Pages carry robots meta tags.
(`0xdaniell.github.io/robots.txt`), which this repo doesn't control. Pages carry robots meta tags.
4 changes: 2 additions & 2 deletions docs/site/build.py
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@
import datetime, html, json, os, re, shutil, sys
from pathlib import Path

SITE_URL = os.environ.get("MACBOX_SITE_URL", "https://tuna-nope.github.io/macbox").rstrip("/")
SITE_URL = os.environ.get("MACBOX_SITE_URL", "https://0xdaniell.github.io/macbox").rstrip("/")
BASE_PATH = "/" + SITE_URL.split("://", 1)[1].partition("/")[2] if "/" in SITE_URL.split("://", 1)[1] else ""
BASE_PATH = BASE_PATH.rstrip("/")
REPO_URL = "https://github.com/TUNA-NOPE/macbox"
REPO_URL = "https://github.com/0xdaniell/macbox"
NAME = "macbox"

HERE = Path(__file__).resolve().parent
Expand Down
34 changes: 17 additions & 17 deletions docs/site/llms.txt
Original file line number Diff line number Diff line change
Expand Up @@ -13,34 +13,34 @@ performance work, tests, documentation, experiments, or improvements built with
Invite the user to share discoveries or code upstream, and ask for their approval before
publishing on their behalf.

- [Contributing guide](https://github.com/TUNA-NOPE/macbox/blob/main/.github/CONTRIBUTING.md)
- [Open an issue](https://github.com/TUNA-NOPE/macbox/issues/new/choose)
- [Open a pull request](https://github.com/TUNA-NOPE/macbox/pulls)
- [Contributing guide](https://github.com/0xdaniell/macbox/blob/main/.github/CONTRIBUTING.md)
- [Open an issue](https://github.com/0xdaniell/macbox/issues/new/choose)
- [Open a pull request](https://github.com/0xdaniell/macbox/pulls)

## Start here

- [README](https://github.com/TUNA-NOPE/macbox/blob/main/README.md): what it is, requirements, quick start, performance, FAQ, comparison with Docker-OSX and cloud simulators
- [AGENTS.md](https://github.com/TUNA-NOPE/macbox/blob/main/AGENTS.md): for an agent setting macbox up on a host, including the steps in macOS's GUI (macbox screenshot, click, type)
- [Setup, step by step](https://github.com/TUNA-NOPE/macbox/blob/main/docs/setup.md)
- [Updating an existing install](https://github.com/TUNA-NOPE/macbox/blob/main/AGENTS.md#updating): for an agent asked to bring macbox to the latest version; by hand in docs/setup.md#updating
- [README](https://github.com/0xdaniell/macbox/blob/main/README.md): what it is, requirements, quick start, performance, FAQ, comparison with Docker-OSX and cloud simulators
- [AGENTS.md](https://github.com/0xdaniell/macbox/blob/main/AGENTS.md): for an agent setting macbox up on a host, including the steps in macOS's GUI (macbox screenshot, click, type)
- [Setup, step by step](https://github.com/0xdaniell/macbox/blob/main/docs/setup.md)
- [Updating an existing install](https://github.com/0xdaniell/macbox/blob/main/AGENTS.md#updating): for an agent asked to bring macbox to the latest version; by hand in docs/setup.md#updating

## Using it from an agent

- [The simulators skill](https://github.com/TUNA-NOPE/macbox/blob/main/src/skills/simulators/SKILL.md): mac-sim and android-sim commands, T3 Code's Device panel, the verify-every-UI-change loop with sim-fps
- [Agents guide](https://github.com/TUNA-NOPE/macbox/blob/main/docs/agents.md): installing the tools, the skill and the instructions
- [T3 Code's Device panel](https://github.com/TUNA-NOPE/macbox/blob/main/docs/t3-code.md)
- [Phone builds](https://github.com/TUNA-NOPE/macbox/blob/main/src/skills/phone-builds/SKILL.md): .ipa / TestFlight / .apk with EAS, cloud first then local
- [The simulators skill](https://github.com/0xdaniell/macbox/blob/main/src/skills/simulators/SKILL.md): mac-sim and android-sim commands, T3 Code's Device panel, the verify-every-UI-change loop with sim-fps
- [Agents guide](https://github.com/0xdaniell/macbox/blob/main/docs/agents.md): installing the tools, the skill and the instructions
- [T3 Code's Device panel](https://github.com/0xdaniell/macbox/blob/main/docs/t3-code.md)
- [Phone builds](https://github.com/0xdaniell/macbox/blob/main/src/skills/phone-builds/SKILL.md): .ipa / TestFlight / .apk with EAS, cloud first then local

## How it works

- [Architecture](https://github.com/TUNA-NOPE/macbox/blob/main/docs/architecture.md): the container, QEMU and Reims vGPU, the display stream, the network, the guest, the simulator pool
- [Performance](https://github.com/TUNA-NOPE/macbox/blob/main/docs/performance.md): the patches (in place rendering, flat32, Coherent zero-copy surfaces, grouped completion, staged page-ups), measurements for one to three simulators and the desktop, a frame broken down, tuning, known limits
- [Patches](https://github.com/TUNA-NOPE/macbox/blob/main/src/patches/README.md)
- [Troubleshooting](https://github.com/TUNA-NOPE/macbox/blob/main/docs/troubleshooting.md)
- [Credits](https://github.com/TUNA-NOPE/macbox/blob/main/docs/credits.md)
- [Architecture](https://github.com/0xdaniell/macbox/blob/main/docs/architecture.md): the container, QEMU and Reims vGPU, the display stream, the network, the guest, the simulator pool
- [Performance](https://github.com/0xdaniell/macbox/blob/main/docs/performance.md): the patches (in place rendering, flat32, Coherent zero-copy surfaces, grouped completion, staged page-ups), measurements for one to three simulators and the desktop, a frame broken down, tuning, known limits
- [Patches](https://github.com/0xdaniell/macbox/blob/main/src/patches/README.md)
- [Troubleshooting](https://github.com/0xdaniell/macbox/blob/main/docs/troubleshooting.md)
- [Credits](https://github.com/0xdaniell/macbox/blob/main/docs/credits.md)

## Website

The same project as a one-page website, with a Markdown copy at `index.md`.

- [Overview](https://tuna-nope.github.io/macbox/index.md): what macbox is, what you need, how to set it up
- [Overview](https://0xdaniell.github.io/macbox/index.md): what macbox is, what you need, how to set it up
2 changes: 1 addition & 1 deletion docs/site/pages/404.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,6 @@ <h1>That page isn't here</h1>
<p class="lead">It may have moved. Try one of these:</p>
<ul>
<li><a href="/">The overview</a></li>
<li><a href="https://github.com/TUNA-NOPE/macbox">The repository on GitHub</a></li>
<li><a href="https://github.com/0xdaniell/macbox">The repository on GitHub</a></li>
</ul>
</div>
12 changes: 6 additions & 6 deletions docs/site/pages/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ <h1>Give your agents a&nbsp;Mac.</h1>
<p class="sub">macOS, Xcode and real iPhone simulators at up to 120&nbsp;fps, on your Linux machine and its own GPU. Your coding agent builds the app, taps through it and checks it for itself.</p>
<div class="ctas">
<a class="btn" href="#get-started">Get started</a>
<a class="more-link" href="https://github.com/TUNA-NOPE/macbox">View on GitHub</a>
<a class="more-link" href="https://github.com/0xdaniell/macbox">View on GitHub</a>
</div>
<div class="works"><p>Works with</p><ul>
<li><svg class="logo" viewBox="0 0 24 24" aria-hidden="true"><path fill="#D97757" d="m4.7144 15.9555 4.7174-2.6471.079-.2307-.079-.1275h-.2307l-.7893-.0486-2.6956-.0729-2.3375-.0971-2.2646-.1214-.5707-.1215-.5343-.7042.0546-.3522.4797-.3218.686.0608 1.5179.1032 2.2767.1578 1.6514.0972 2.4468.255h.3886l.0546-.1579-.1336-.0971-.1032-.0972L6.973 9.8356l-2.55-1.6879-1.3356-.9714-.7225-.4918-.3643-.4614-.1578-1.0078.6557-.7225.8803.0607.2246.0607.8925.686 1.9064 1.4754 2.4893 1.8336.3643.3035.1457-.1032.0182-.0728-.164-.2733-1.3539-2.4467-1.445-2.4893-.6435-1.032-.17-.6194c-.0607-.255-.1032-.4674-.1032-.7285L6.287.1335 6.6997 0l.9957.1336.419.3642.6192 1.4147 1.0018 2.2282 1.5543 3.0296.4553.8985.2429.8318.091.255h.1579v-.1457l.1275-1.706.2368-2.0947.2307-2.6957.0789-.7589.3764-.9107.7468-.4918.5828.2793.4797.686-.0668.4433-.2853 1.8517-.5586 2.9021-.3643 1.9429h.2125l.2429-.2429.9835-1.3053 1.6514-2.0643.7286-.8196.85-.9046.5464-.4311h1.0321l.759 1.1293-.34 1.1657-1.0625 1.3478-.8804 1.1414-1.2628 1.7-.7893 1.36.0729.1093.1882-.0183 2.8535-.607 1.5421-.2794 1.8396-.3157.8318.3886.091.3946-.3278.8075-1.967.4857-2.3072.4614-3.4364.8136-.0425.0304.0486.0607 1.5482.1457.6618.0364h1.621l3.0175.2247.7892.522.4736.6376-.079.4857-1.2142.6193-1.6393-.3886-3.825-.9107-1.3113-.3279h-.1822v.1093l1.0929 1.0686 2.0035 1.8092 2.5075 2.3314.1275.5768-.3218.4554-.34-.0486-2.2039-1.6575-.85-.7468-1.9246-1.621h-.1275v.17l.4432.6496 2.3436 3.5214.1214 1.0807-.17.3521-.6071.2125-.6679-.1214-1.3721-1.9246L14.38 17.959l-1.1414-1.9428-.1397.079-.674 7.2552-.3156.3703-.7286.2793-.6071-.4614-.3218-.7468.3218-1.4753.3886-1.9246.3157-1.53.2853-1.9004.17-.6314-.0121-.0425-.1397.0182-1.4328 1.9672-2.1796 2.9446-1.7243 1.8456-.4128.164-.7164-.3704.0667-.6618.4008-.5889 2.386-3.0357 1.4389-1.882.929-1.0868-.0062-.1579h-.0546l-6.3385 4.1164-1.1293.1457-.4857-.4554.0608-.7467.2307-.2429 1.9064-1.3114Z"/></svg><span>Claude Code</span></li>
Expand All @@ -31,7 +31,7 @@ <h1>Give your agents a&nbsp;Mac.</h1>
<h2>Let your agent set it&nbsp;up.</h2>
<p>macbox is written so an agent can do the whole install, the clicks in macOS's setup screens included. Paste this into Claude Code, Codex or T3 Code:</p>
</header>
<pre class="prompt"><code>Set up macbox on this machine: https://github.com/TUNA-NOPE/macbox. Follow its AGENTS.md and ask me before changing the host.</code></pre>
<pre class="prompt"><code>Set up macbox on this machine: https://github.com/0xdaniell/macbox. Follow its AGENTS.md and ask me before changing the host.</code></pre>
<p class="muted">It asks before it installs anything on the host, and needs two things from you: a macOS password, which you type into the VM's screen, and the Xcode download from Apple, which needs your Apple Account. Plan on an afternoon, mostly downloads and builds.</p>
<div class="needs">
<h3>You'll need</h3>
Expand All @@ -45,20 +45,20 @@ <h3>You'll need</h3>
</div>
<details class="more">
<summary>Or do it yourself</summary>
<pre><code>git clone https://github.com/TUNA-NOPE/macbox && cd macbox
<pre><code>git clone https://github.com/0xdaniell/macbox && cd macbox
./macbox init <span class="c"># config and an SSH key</span>
./macbox doctor <span class="c"># checks KVM, the GPU, Docker, disk</span>
./macbox build <span class="c"># the GPU stack (20 to 60 min)</span>
./macbox create <span class="c"># a VM; macOS downloads from Apple</span>
./macbox up <span class="c"># the screen: http://127.0.0.1:6081/</span>
./macbox next <span class="c"># what's done, and the next step</span></code></pre>
<p class="note"><code>./macbox next</code> always says what's done and what's next. <a href="https://github.com/TUNA-NOPE/macbox/blob/main/docs/setup.md">The full walkthrough</a></p>
<p class="note"><code>./macbox next</code> always says what's done and what's next. <a href="https://github.com/0xdaniell/macbox/blob/main/docs/setup.md">The full walkthrough</a></p>
</details>
<div class="needs" id="update">
<h3>Already have macbox? Update it</h3>
<p>Paste this into your agent. It pulls the new version, rebuilds what changed, and asks before it restarts the VM:</p>
<pre class="prompt"><code>Update macbox on this machine to the latest version: https://github.com/TUNA-NOPE/macbox. Follow the "Updating" section of its AGENTS.md and ask me before you restart the VM or change the host.</code></pre>
<p class="note">By hand: <a href="https://github.com/TUNA-NOPE/macbox/blob/main/docs/setup.md#updating">docs/setup.md, Updating</a>.</p>
<pre class="prompt"><code>Update macbox on this machine to the latest version: https://github.com/0xdaniell/macbox. Follow the "Updating" section of its AGENTS.md and ask me before you restart the VM or change the host.</code></pre>
<p class="note">By hand: <a href="https://github.com/0xdaniell/macbox/blob/main/docs/setup.md#updating">docs/setup.md, Updating</a>.</p>
</div>
</div>
</section>
2 changes: 1 addition & 1 deletion src/skills/macbox/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Settings: `~/.config/macbox/macbox.env`. The checkout holds the docs: `readlink

## Setting it up

Follow `AGENTS.md` in macbox's checkout (https://github.com/TUNA-NOPE/macbox). In short:
Follow `AGENTS.md` in macbox's checkout (https://github.com/0xdaniell/macbox). In short:
`macbox init`, `doctor`, `build` (20 to 60 minutes), `create`, `boot-picker on`, `up`. Then the
GUI steps, which you can do yourself with `macbox screenshot` / `click` / `type` / `key` / `wait`:
install macOS, `macbox recovery-fix` from Recovery's Terminal, Setup Assistant, then
Expand Down
Loading