{
  "@context": "https://schema.org",
  "@id": "https://aggr.aymericbeaumet.com/items/ampcode-com/2026-10-16-see-your-runner-s-desktop/#webpage",
  "@type": [
    "WebPage",
    "ArchiveComponent"
  ],
  "articleBody": "You can now see and control your macOS or Linux runner's desktop. This is nice for trying native apps that Amp builds for you, such as iOS apps:\n\nTurn on **Share This Mac's Display** under Settings › Runner in the [macOS app](https://ampcode.com/app), or start your runner with `amp --no-tui --desktop`.\n\n![The Runner tab in the Amp macOS app's settings, with Share This Mac's Display turned on and its Sharing status highlighted.](https://static.ampcode.com/news/runner-desktop-settings-light.png) ![The Runner tab in the Amp macOS app's settings, with Share This Mac's Display turned on and its Sharing status highlighted.](https://static.ampcode.com/news/runner-desktop-settings-dark.png)\n\nYour Amp client connects directly to the runner, so it's nearly instant when the runner is on your local network or nearby.\n\nRead [See and Control the Runner's Desktop](https://ampcode.com/docs/cli/runners#see-and-control-the-runners-desktop) for more details.\n",
  "authors": [],
  "captured_at": "2026-10-16T22:01:23.127136231+00:00",
  "category": "programming",
  "content_html": "<p>You can now see and control your macOS or Linux runner's desktop. This is nice for trying native apps that Amp builds for you, such as iOS apps:</p>\n<p>Turn on <strong>Share This Mac's Display</strong> under Settings › Runner in the <a target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://ampcode.com/app\">macOS app</a>, or start your runner with <code>amp --no-tui --desktop</code>.</p>\n<p><picture class=\"article-picture article-picture-fallback\" style=\"--image-ratio:16 / 9\"><img src=\"https://static.ampcode.com/news/runner-desktop-settings-light.png\" alt=\"The Runner tab in the Amp macOS app&#39;s settings, with Share This Mac&#39;s Display turned on and its Sharing status highlighted.\" loading=\"eager\" decoding=\"async\" fetchpriority=\"high\" referrerpolicy=\"no-referrer\" class=\"progressive-image\"></picture> <picture class=\"article-picture article-picture-fallback\" style=\"--image-ratio:16 / 9\"><img src=\"https://static.ampcode.com/news/runner-desktop-settings-dark.png\" alt=\"The Runner tab in the Amp macOS app&#39;s settings, with Share This Mac&#39;s Display turned on and its Sharing status highlighted.\" loading=\"lazy\" decoding=\"async\" fetchpriority=\"low\" referrerpolicy=\"no-referrer\" class=\"progressive-image\"></picture></p>\n<p>Your Amp client connects directly to the runner, so it's nearly instant when the runner is on your local network or nearby.</p>\n<p>Read <a target=\"_blank\" rel=\"noopener noreferrer\" href=\"https://ampcode.com/docs/cli/runners#see-and-control-the-runners-desktop\">See and Control the Runner's Desktop</a> for more details.</p>\n",
  "content_markdown": "You can now see and control your macOS or Linux runner's desktop. This is nice for trying native apps that Amp builds for you, such as iOS apps:\n\nTurn on **Share This Mac's Display** under Settings › Runner in the [macOS app](https://ampcode.com/app), or start your runner with `amp --no-tui --desktop`.\n\n![The Runner tab in the Amp macOS app's settings, with Share This Mac's Display turned on and its Sharing status highlighted.](https://static.ampcode.com/news/runner-desktop-settings-light.png) ![The Runner tab in the Amp macOS app's settings, with Share This Mac's Display turned on and its Sharing status highlighted.](https://static.ampcode.com/news/runner-desktop-settings-dark.png)\n\nYour Amp client connects directly to the runner, so it's nearly instant when the runner is on your local network or nearby.\n\nRead [See and Control the Runner's Desktop](https://ampcode.com/docs/cli/runners#see-and-control-the-runners-desktop) for more details.\n",
  "dateCreated": "2026-10-16T22:01:23.127136231+00:00",
  "date_created": "2026-10-16T00:00:00+00:00",
  "date_modified": "2026-10-16T00:00:00+00:00",
  "date_published": "2026-10-16T00:00:00+00:00",
  "description": "You can now see and control your macOS or Linux runner's desktop. This is nice for trying native apps that Amp builds for you, such as iOS apps: Turn on Share This Mac's Display under Settings › Runner in the macOS app, or start your…",
  "external_url": "https://ampcode.com/news/runner-desktop",
  "git": {
    "commit": "ebb0941c5c06a2ab2377342d607535262a3e969e",
    "path": "items/ampcode-com/2026/10/2026-10-16-see-your-runner-s-desktop.md",
    "permalink": "https://github.com/aymericbeaumet/aggr-instance/blob/ebb0941c5c06a2ab2377342d607535262a3e969e/items/ampcode-com/2026/10/2026-10-16-see-your-runner-s-desktop.md"
  },
  "id": "urn:aggr:item:6486481159f9d2546f307611e9168a8d89c3de4f",
  "isBasedOn": {
    "@id": "https://ampcode.com/news/runner-desktop"
  },
  "mainEntity": {
    "@id": "https://ampcode.com/news/runner-desktop",
    "@type": "CreativeWork",
    "archivedAt": {
      "@id": "https://aggr.aymericbeaumet.com/items/ampcode-com/2026-10-16-see-your-runner-s-desktop/#webpage"
    },
    "dateModified": "2026-10-16T00:00:00+00:00",
    "datePublished": "2026-10-16T00:00:00+00:00",
    "headline": "See Your Runner's Desktop",
    "image": {
      "@type": "ImageObject",
      "caption": "The Amp macOS app with a thread beside its runner's shared Mac desktop. Clicking Open the iOS app in the transcript opens the Desktop tab, where the cursor opens a thread in the iPhone Simulator and taps its header, showing Archive at the top of the menu.",
      "height": 90,
      "url": "https://static.ampcode.com/news/runner-desktop-ios-light-poster.avif",
      "width": 160
    },
    "timeRequired": "PT1M",
    "url": "https://ampcode.com/news/runner-desktop",
    "wordCount": 82
  },
  "name": "Archived snapshot: See Your Runner's Desktop",
  "preview": {
    "alt": "The Amp macOS app with a thread beside its runner's shared Mac desktop. Clicking Open the iOS app in the transcript opens the Desktop tab, where the cursor opens a thread in the iPhone Simulator and taps its header, showing Archive at the top of the menu.",
    "color": null,
    "height": 90,
    "placeholder": {
      "data_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=",
      "hash": ""
    },
    "url": "https://static.ampcode.com/news/runner-desktop-ios-light-poster.avif",
    "width": 160
  },
  "reading_minutes": 1,
  "replicated_at": null,
  "source": "ampcode-com",
  "source_name": "Amp News",
  "summary": "You can now see and control your macOS or Linux runner's desktop. This is nice for trying native apps that Amp builds for you, such as iOS apps: Turn on Share This Mac's Display under Settings › Runner in the macOS app, or start your runner with amp --no-tui --desktop. Your Amp client connects directly to the runner, so it's nearly instant when the runner is on your local network or nearby. Read See and Control the Runner's Desktop for more details.",
  "tags": [],
  "temporalCoverage": "2026-10-16T22:01:23.127136231+00:00",
  "title": "See Your Runner's Desktop",
  "url": "https://aggr.aymericbeaumet.com/items/ampcode-com/2026-10-16-see-your-runner-s-desktop/",
  "word_count": 82
}