convez.ai
Skill
chimera-defi

claude-remote-session-skill

chimera-defi/claude-remote-session-skill

Ver no GitHub
InicialPluginScore · de 0 a 100

gstack-compatible skill for spinning up persistent Claude Code remote sessions via tmux + systemd

Instalação

$npx convez-ai chimera-defi/claude-remote-session-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 dias
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

claude-remote-session-skill

A gstack-compatible Claude Code skill that creates persistent remote Claude sessions via tmux + systemd.

Say "create a session for my-project" and Claude will spin up a session you can connect to from any device — iPhone, desktop, or browser — via the Claude Code remote control feature.

What it does

  • Creates a named tmux session running claude --remote-control <name> in a loop
  • Wraps it in a systemd user service so it survives reboots and restarts automatically
  • Uses --dangerously-skip-permissions so sessions never block on tool approval prompts
  • Sentinel file + --continue so sessions resume conversation context after restarts
  • Smart backoff: 300s pause on quick exits (rate limit / crash), 10s otherwise

Requirements

  • Linux with systemd user services
  • tmux
  • Claude Code CLI (claude) installed at /usr/bin/claude (or adjust paths)
  • Python 3 (for trust pre-acceptance)

Install

# Option A — symlink into global Claude skills (available in every Claude session)
ln -sf "$(pwd)" ~/.claude/skills/gstack-session-spawn

# Option B — clone and symlink
git clone https://github.com/chimera-defi/claude-remote-session-skill.git
ln -sf ~/workspace/claude-remote-session-skill ~/.claude/skills/gstack-session-spawn

Use from Claude Code

In any Claude Code session, type:

/gstack-session-spawn

Then tell Claude which project to create a session for. It will generate the scripts, enable the systemd service, and tell you the remote-control name to connect with.

Use the script directly

FOLDERNAME=my-project bash scripts/create-session.sh

The session will appear in the Claude Code app under Remote sessions as agenthost-my-project-<date>.

Naming convention

WhatFormat
tmux sessionagenthost_<folder>-<YYYYMMDD> (underscore — tmux converts : to _)
remote-control nameagenthost-<folder>-<YYYYMMDD> (hyphens — shown in Claude Code app)
start script~/.local/bin/agenthost-<folder>-<YYYYMMDD>-start.sh
systemd service~/.config/systemd/user/agenthost-<folder>-<YYYYMMDD>.service

How connect works

Once the session is running, open Claude Code on any device → Remote sessions → look for agenthost-<folder>-<date>. The session keeps your conversation context across restarts via --continue.

License

MIT

Ver o original no GitHub

Bom para

Relacionados