t3serve

Keep npx t3@nightly serve running on macOS.

t3serve creates a small per-user macOS service for npx t3@nightly serve. It starts when you log in, restarts if it crashes, and stays out of the way.

Get started

npm i -g t3-serve
t3serve load

load sets up the service and starts the server. You only need it once, or again after running unload.

While the server starts, t3serve waits with a small spinner in interactive terminals and then shows its localhost address, a fresh pair token, the complete pairing URL, and whether T3 Connect is connected. start shows the same connection details.

Both command names work:

t3serve status
t3-serve status

Commands

t3serve load         Set up and start the service
t3serve unload       Stop and remove the service
t3serve start        Start the server
t3serve stop         Stop the server
t3serve restart      Restart the server
t3serve status       Show the server status
t3serve help         Show help

Everyday use

After t3serve load, these are the commands you will normally use:

t3serve status
t3serve restart
t3serve stop
t3serve start

stop keeps the setup in place, so start brings the server back later.

Run t3serve unload only when you want to stop the server and remove its macOS setup. To use t3serve again afterward, run t3serve load.

Logs

The server runs from your home directory. Logs are written to:

~/Library/Logs/t3serve.log
~/Library/Logs/t3serve-error.log

Follow the live server log with:

tail -f ~/Library/Logs/t3serve.log

Requirements

• macOS
• Node.js 18 or newer

t3serve checks your operating system during installation and stops with a clear message when it is not running on macOS.

On Linux with systemd, use T3 Code's built-in background service instead:

npx t3@latest service install

See the T3 Code background service documentation for status, updates, and removal instructions.

Development

npm test
npm run check

License

MIT