Index / agent

remote-claude-code-tmux

github.com/avanderheyde/remote-claude-code-tmux

Category: AI Agents
Rank: No. 2202Tools index
Previous survey · No. 2170 · 28 August 2026
Pricing: Open Source
Type: AGENT
Builder: @Alderik_
Date: Indexed Jul 21, 2026

About

A Claude Code agent skill that sets up Claude Code to run persistently on a remote server inside tmux, so work continues when the SSH connection drops and the session can be reattached later from a laptop or a phone. It installs the required tooling via a setup script and adds a `tm` helper that keeps one tmux session per project folder.

What it does

This Agent Skill packages a shell workflow for keeping interactive coding tasks alive on an always-on machine. It installs tmux, adds a short command that maps each project folder to a session, and automatically reconnects interactive SSH logins without trapping file transfers or scripted commands.

Why it's ranked here

A focused, legible solution to a narrow operational problem. Folder-based session reuse prevents duplicate-session clutter, while guarded auto-attachment handles ordinary SSH use without interfering with scp, rsync, or scripted connections. Its value depends on accepting tmux and Bash as the operating model.

What's good

The helper handles two easy-to-miss details: it switches sessions instead of nesting tmux, and sanitizes folder names that tmux rejects. Setup is idempotent, manual instructions remain available, and authentication on a headless server is explained through either a browser-link flow or an API key.

Tradeoffs

Sessions survive network loss, not machine reboots. The installer recognizes only apt-get and Homebrew, otherwise tmux needs manual installation. It edits the user's Bash startup configuration and optionally installs Claude Code globally, which requires Node and npm. Mobile access still requires an SSH application, credentials, and server connectivity.

How to use it well

Use it for long interactive Claude Code tasks on a VPS, spare desktop, Raspberry Pi, or other always-on box, especially when switching between laptop and phone. Keep each project in its own session and reserve system service management for reboot-persistent workloads. It does not provision, secure, or host applications on the server.

Technical notes+

scripts/setup.sh uses set -euo pipefail, installs tmux through apt-get or brew, and appends an idempotently marked tm() definition plus an interactive-shell auto-attach guard to ~/.bashrc. The helper derives a session name from $PWD, replaces dots and colons, uses tmux switch-client when $TMUX is set, and otherwise attaches or creates a session. Its optional --with-claude branch requires Node and runs a global npm install. SKILL.md contains the complete workflow, README.md provides the quickstart, and LICENSE supplies the MIT terms.

Observed

License: MIT
Primary language: Bash shell scripting
Packaging: Claude Code Agent Skill with a standalone setup script
Install surface: Git clone and project-local skill copy, or direct Bash setup
Interface: Shell command helper and automatic attachment for interactive SSH logins
Package managers: Installs tmux through apt-get or Homebrew; optional Claude Code installation uses npm
Platform scope: Documented for always-on remote machines, including VPS hosts, spare desktops, and Raspberry Pi devices

Read from README.md, LICENSE, SKILL.md, scripts/setup.sh.

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.