October 6, 2026 · TermBridge · 3 min read

Monitor Ledge.sh Runnable Notes on Mac Terminal from iPhone

Monitor Ledge.sh Runnable Notes on Mac Terminal from iPhone

Many developers face the frustration of constantly copying commands from their notes and pasting them into a terminal. This creates a mental disconnect between documented procedures and active execution, making it hard to track long-running tasks or respond quickly.

Hi HN, Ledge is a Markdown notebook that runs shell commands, code, SQL, etc from inside your own notes. I built Ledge because I spend much of my day copy/pasting commands from my notes into the terminal. I was inspired by how much cmux helped me organize my terminals - but there was still a split brain between my notes and frequently run commands. I’ve been daily-driving it for the past few weeks and use it for deploys, API calls, smoke tests, etc. Ledge runs your real shell just like a terminal app and can be hosted locally or remotely over SSH using ledge-server. I’ve been building it since July and have recently added support for all the major platforms: Mac (Silicon), Windows (WSL required), Linux, iOS, Android. Mobile devices require SSH access to a ledge-server and Android is still in beta and looking for beta testers (see link on website)! It’s built on Bun and Electrobun and is free and open-source. Feel free to review the code and contribute at https://github.com/ledgesh/ledge Feedback is very much welcome. Any must-have features that are mis

TermBridge addresses this by mirroring your Mac’s actual terminal directly to your iPhone or iPad. When you run commands from Ledge.sh on your Mac, TermBridge allows you to watch their output, type new input, and control the session remotely. This means you can initiate a complex agent run or a deployment script via Ledge, then step away from your desk while keeping full visibility and control from your mobile device.

Code on a computer screen with binary data and a person's hands on a keyboard

Monitoring Ledge.sh Runs from Anywhere

Ledge.sh aims to keep your runnable commands close to your notes, reducing the need for constant copy/pasting. Once these commands are running on your Mac, especially long-running processes like Claude Code or Codex agent simulations, TermBridge extends that convenience. You can monitor the progress, check for errors, or respond to prompts directly from your iPhone or iPad, without being tethered to your desk. This is particularly useful for tasks that require intermittent attention but do not demand constant supervision.

Direct Access to Your Mac’s Real Shell

While Ledge.sh offers mobile access via SSH to a ledge-server, TermBridge provides a different approach for accessing your Mac’s terminal. It directly mirrors your existing iTerm2, Terminal.app, or integrated VS Code terminal sessions. This means you are interacting with the exact shell environment on your Mac, without needing to set up an additional SSH server on your Mac for mobile access. This simplifies remote monitoring, letting you keep an eye on everything from agent model routing performance to privacy scans. For more on this, see our post on monitoring Claude Code and Codex Mac terminal from iPhone, no SSH.

iPhone screen showing multiple terminal sessions in TermBridge

Secure and Simple Remote Control

TermBridge prioritizes security and ease of use. Pairing your iPhone or iPad with your Mac is done via a simple QR code scan and on-Mac approval. All communication is end-to-end encrypted using X25519 and AES-256-GCM, ensuring your terminal sessions remain private. You can pair multiple devices to one Mac or switch between multiple Macs, giving you flexible control over all your development environments, whether you are running Ledge.sh commands or any other terminal-based task. This discussion on Hacker News highlights the ongoing need for better terminal management: Show HN: Ledge.sh – Runnable Markdown Notes.

Discussed on Hacker News · 204 pts · 88 💬

Discussed on

← Back to Blog