Skip to content
Skills Library
AI & agents · Tool integration

fork-session

/fork-session

Fork the current Claude Code session into an independent copy (new session id, the original untouched) that starts connected to Remote Control in its own window. Built for the phone, where the Claude app has no fork button. Use when the user says "/fork-session", "fork this session", "fork it", "duplicate the session", "open a copy of this session", or "I want to try another direction without losing this one". Accepts an optional name ("fork as try-redis").

Licence
MIT
Last repository change
13.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Fork the current Claude Code session into an independent copy (new session id, the original untouched) that starts connected to Remote Control in its own window. Built for the phone, where the Claude app has no fork button. Use when the user says "/fork-session", "fork this session", "fork it", "duplicate the session", "open a copy of this session", or "I want to try another direction without losing this one". Accepts an optional name ("fork as try-redis").

Triggers from the description

fork this sessionfork itduplicate the sessionopen a copy of this sessionI want to try another direction without losing this onefork as try-redis
Original author description

Fork the current Claude Code session into an independent copy (new session id, the original untouched) that starts connected to Remote Control in its own window. Built for the phone, where the Claude app has no fork button. Use when the user says "/fork-session", "fork this session", "fork it", "duplicate the session", "open a copy of this session", or "I want to try another direction without losing this one". Accepts an optional name ("fork as try-redis").

How it works

  1. Purpose
  2. Instructions
  3. Steps
  4. Prerequisites
  5. Limitations
  6. Troubleshooting
  7. Examples
Original SKILL.md headings · 56 lines, 544 words
SKILL.md preview
---
name: fork-session
description: Fork the current Claude Code session into an independent copy (new session id, the original untouched) that starts connected to Remote Control in its own window. Built for the phone, where the Claude app has no fork button. Use when the user says "/fork-session", "fork this session", "fork it", "duplicate the session", "open a copy of this session", or "I want to try another direction without losing this one". Accepts an optional name ("fork as try-redis").
version: "0.5.5"
metadata:
  author: Lucas Saldanha Werneck <lucas@2olhares.com>
  tags: [fork, remote-control, sessions]
---

# fork-session

## Purpose

Fork the current session into an independent copy from the phone, where the Claude app has no fork button, and keep the original untouched.

Creates a COPY of the current session without stopping or changing the original. The copy gets a new session id and inherits all context up to the last completed turn. It starts with `--remote-control`, so it shows up in the Claude app's session list within seconds: this is how you fork from a phone, by asking here.

## Instructions

1. Take the current session id and a name for the copy.
2. Run `claude-fork --name "<name>"` from this session's folder.
3. Wait about 15 seconds and verify the copy is alive before saying it worked.
4. Report the copy's name; to discard it, kill its tmux session.

## Steps

1. **Session id** = this session's id: `$CLAUDE_CODE_SESSION_ID` when set (`claude-fork` uses it by default); otherwise the UUID in this session's transcript or scratchpad path.
2. **Name of the copy**: the one the user gave; otherwise `fork <short topic of this session>`. Only letters, digits, spaces and hyphens.
3. **Launch** from this session's folder:

   ```bash
   claude-fork --name "<name>"            # or: claude-fork <session-id> --name "<name>"
   ```

   The copy must be easy to tell apart from the original at a glance: its own window and its own name. With tmux installed it gets its own tmux session (`fork-HHMMSS`) and, on macOS, a new iTerm or Terminal window attached to it. Without tmux, macOS opens a window running the copy directly. On Linux without a desktop terminal it stays a detached tmux session; tell the user.
4. **Verify before claiming** (wait about 15 seconds, polling with a deadline):
   - process alive: `pgrep -fl -- --fork-session`
   - with tmux: `tmux capture-pane -p -t fork-HHMMSS`; a good start shows the "/remote-control is active" line and the idle prompt.
   - if available: `claude agents --json` lists the new session.
5. **Report**: the copy's name + "it should appear in your app list shortly". If the process died, paste the captured output; do NOT say it worked.
6. **To discard a copy**: `tmux kill-session -t fork-HHMMSS` (the attached window closes by itself; confirm with `pgrep -fl -- --fork-session`), or exit the copy normally.

Known limitations (phantom tasks, last turn missing): see `references/limitations.md`.

## Prerequisites

- Claude Code with the `--fork-session` and `--remote-control` flags, and Python 3.8+.
- `claude-fork` (installed by the plugin or the repo installer). tmux is optional on macOS and needed on Linux.

## Limitations

See `references/limitations.md`: phantom "running tasks" in the copy (cosmetic), and the turn in progress may be missing from the copy.

## Troubleshooting

- The copy did not start: paste the output of `tmux capture-pane -p -t fork-HHMMSS` and say it failed; do not claim it worked.
- No terminal window opened on Linux without a desktop terminal: the copy stays a detached tmux session; attach with `tmux attach -t fork-HHMMSS`.

## Examples

- User: "/fork-session". Claude runs `claude-fork` with a name like `fork <topic>`, checks the copy is running and says it should appear in the app list shortly.
- User: "fork it as try-redis". Claude runs `claude-fork --name "try-redis"`.
- User: "I want to try another direction without losing this one". Same as a fork request.
Files in this package (2)
  • SKILL.md 4 KB
  • references/limitations.md 1 KB

Versions

RepositoryScoreLicence
This page · lucas-saldanha-werneck/remote-sessions100MIT
inbarajaldrin/devdroid100Apache-2.0

Database snapshot: 13.11.2026 · package version e8244b9a6b60 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 96claude-rc-open
    Start a new Claude Code session in another local repository that can be driven from the phone or claude.ai via Remote Control. It runs as an interactive session with permissions bypassed, in the background, so several can run at once, even in the same repository. Use when the…
  • 100session-fork-conversation
    Session — Fork the current conversation into a new one, either a full copy or a clean one with a written handoff. Use when the person says "haz un fork", "forkea la conversación", "bifurca", "abre otra conversación para...", "lanza otro agente con...", "pásale esto a una sesión…
  • 100open-session
    Open or resume a Claude Code session of another project folder on this computer, in a new terminal window or in the Claude desktop app, with Remote Control on, picking project, folder and session from numbered lists. Built for use from the phone through Remote Control, where…
  • 100wise-fork
    Reorient the agent after a session fork: inherited context becomes read-only background and pre-fork work stays with the original session. Every in-flight task, plan, and promise from before the fork is dropped, remembered file state is distrusted, and this session starts fresh…
  • 100spawn-session
    Start a new detached Claude Code Remote Control session inside Herdr, so it shows in the Claude mobile app. Use when asked to start a session for a project (新しいセッション立てて).
  • 100new
    Hand the current task to a brand-new Claude Code session that starts working on it immediately. Saves a handoff document (unless given one), then starts a fresh session through the Claude desktop app's session tool, messages an idle running session, or opens a new terminal…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.