Why it is worth attention

It addresses the common pain point of agents and builds dying when a laptop is closed, by offloading them to a low-power always-on machine and exposing them securely over the internet.

Who it is for

Developers running autonomous coding agents or long build pipelines
Remote workers who need persistent dev servers accessible from anywhere
Developers tired of battery drain and fan noise from heavy local builds
Teams wanting a consistent Linux environment to avoid 'works on my machine' issues

Use cases

Run build agents and test suites that must continue even after you close your laptop
Host dev servers that are reachable over HTTPS from any network
Keep autonomous coding agents running 24/7 without relying on a laptop being open
Offload heavy compilation or CI-like workloads from a Mac to a cheap Linux box

Strengths

Uses only four open-source/free tools (Herdr, Syncthing, Cloudflare Tunnel, Caddy)
Eliminates agents dying on lid close and battery drain from heavy tasks
Provides secure remote access with no open ports via Cloudflare Tunnel
Keeps files in sync automatically both ways using Syncthing

Considerations

Requires purchasing and maintaining a separate always-on Linux mini PC
Relies on internet connectivity for remote access and sync
Security requires careful setup (Cloudflare Access, SSH keys, patching) to avoid exposure

README quick start

Always-On Remote Agent Workspace

Code from your laptop. Run the work on a tiny Linux box that never sleeps. Close the lid, go offline, come back — your agents are still running.

This is a blueprint for a remote-first coding setup: your IDE stays on your Mac, but every long-running task — build agents, test suites, dev servers, autonomous coding agents — lives on an always-on Linux mini PC. You connect to it over the internet, so "where you are" stops mattering.

The idea in one picture

              YOUR MAC                                THE BOX
   ┌──────────────────────────────┐       ┌──────────────────────────────┐
   │                              │       │   Always-on Linux mini PC     │
   │   IDE  ──────────────────────┼──SSH──┼─▶ agents / dev servers run    │
   │   (edit, review, drive)      │ Herdr │   here 24/7                   │
   │                              │remote │                               │
   │   Files on disk  ◀───────────┼──sync─┼─▶ Files on disk               │
   │                              │ Sync  │   (Syncthing keeps them       │
   │                              │ thing │    identical both ways)       │
   └──────────────────────────────┘       └───────────────┬──────────────┘
                  ▲                                        │
                  │                              Cloudflare Tunnel (outbound)
                  │  https://app-dev.example.com           │
                  └────────────────────────────────────────┘
                     view any app running on the box,
                     from any network, over HTTPS

Close your Mac and the box keeps running. Reopen it tomorrow on a different network and reconnect — nothing was lost, because nothing important was ever running on the Mac.

Why do this?

Without it	With it
Agents die when you close your laptop	Agents run 24/7 on the box
Heavy builds drain your battery & fans	Heavy work offloads to the mini PC
"Works on my machine" drift	One stable Linux environment
Dev servers only reachable on your LAN	Reachable anywhere over HTTPS
Tied to one desk / one network	Work from anywhere, any device

The four building blocks

Tool	Role	One-liner
Herdr (remote mode)	Remote connection	Your IDE/terminal

Description

Blueprint for an always-on remote agent workspace: code on your Mac, run the work on an always-on Linux box (Herdr + Syncthing + Cloudflare Tunnel + Caddy).

Related repositories

Similar projects matched by category, topics, and programming language.

MoonshotAI

Featured

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI & Machine LearningAI Agents

3,348

xuchonglang

Featured

investing-for-beginners

A structured investing guide for Chinese beginners covering US stocks, options, and cryptocurrency, with focus on foundational concepts and risk awareness.

Blockchain & Web3

2,739

Krishnagangwal

Featured

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

Data & DatabasesDatabases & Storage

2,326