claude-remote

Manage remote-control Claude Code sessions in Terminal.app via a shell script.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/Ben2pc/g-claude-code-plugins --skill claude-remote
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: claude-remote
Source: https://github.com/Ben2pc/g-claude-code-plugins/tree/main/plugins/claude-remote/skills/claude-remote
Command: npx skills add https://github.com/Ben2pc/g-claude-code-plugins --skill claude-remote

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires python3, and includes scripts (resource) components.

What problem does it solve?

Efficiently manage Claude Code remote-control sessions from macOS Terminal, replacing manual window handling and scattered notes with a single workflow.

Core Features & Use Cases

  • Start, stop, list, and resume remote-control Claude Code sessions via a dedicated session manager.
  • Centralize session state under ~/.claude-remote/ and maintain Terminal.app windows for isolation.
  • Use in environments where remote access or mobile control of Claude Code is required, such as demos, remote debugging, or collaborative sessions.

Quick Start

Run the session manager to create and manage a remote Claude Code session in your workspace.

Frequently Asked Questions about claude-remote

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage remote-control Claude Code sessions in macOS Terminal?โ–ผ

You can manage remote-control Claude Code sessions in macOS Terminal by using a dedicated session manager to start, stop, list, and resume sessions while maintaining isolated Terminal.app windows.

Can I use this session manager for mobile access to Claude Code?โ–ผ

Yes, this session manager supports mobile access to Claude Code by centralizing session state under a dedicated directory, allowing you to resume remote-control sessions from mobile or remote desktop environments.

How does macOS Terminal.app automation work for remote Claude Code sessions?โ–ผ

macOS Terminal.app automation handles window isolation for remote Claude Code sessions, replacing manual window handling with a single workflow that maintains separate terminal instances for each active session.

Do I need python3 to run remote-control Claude Code sessions on macOS?โ–ผ

Yes, python3 is required as a dependency to run the shell scripts that manage remote-control Claude Code sessions and handle the underlying session state directory operations on macOS.

What is the best way to organize Claude Code session state on macOS?โ–ผ

The best way to organize Claude Code session state on macOS is to centralize it under a dedicated ~/.claude-remote directory, replacing scattered notes with a standardized state management workflow.

Why does my Claude Code remote session stop when I close the macOS Terminal window?โ–ผ

Closing the macOS Terminal window may interrupt the active remote session because the session manager relies on Terminal.app automation for window handling and isolation to maintain the connection.