rc-session

name	rc-session
description	Start or hand off a named assistant session inside zellij. Use when the user runs /rc-session, says "start a session" or "start an rc session", or wants to switch between mobile/browser SSH and CLI for Claude remote-control or Codex. Use `klaude handoff` for Claude and `kodex handoff` for Codex. Do not create or ask about worktrees.

Start an RC Session

Start a named assistant session in detached zellij, without creating a worktree. The same session can then be attached from mobile/browser SSH or from a local CLI.

Defaults

• Claude: run klaude handoff — it launches the crc-kirin binary inside the session.
• Codex: run kodex handoff — it launches the codex binary inside the session.
• Directory: use the current working directory unless the user explicitly gives another path.
• Name: the default session NAME is the cwd basename. Prefer a user-provided name; if none is given and the basename would be unclear, ask for a short name.

Gather Only What Is Missing

Ask only for:

• Target assistant, if the user did not say Claude, Codex, crc, or rc.
• Session name, if no usable name can be derived.

Do not ask about worktrees, ticket systems, categories, harnesses, or wrappers.

Target selection:

• Choose Claude when the user says Claude, crc, remote control, phone-driveable, or just rc without saying Codex.
• Choose Codex when the user says Codex.
• Treat "mobile to CLI", "CLI to mobile", "phone", "handoff", "switch devices", and "continue from terminal" as a handoff request.

Launch

Run one of these from the intended working directory:

klaude handoff -n "<slug>"
kodex handoff -n "<slug>"

Pass any extra agent flags after the name. Examples:

klaude handoff -n "pe-investigate" --model opus
kodex handoff -n "codex-spike" --model <model>

Notes:

• Existing session name: if a zellij session with that name already exists, klaude/kodex ignore ALL agent flags and just attach to it. Pick a new name if the flags must apply — and the report must say the session was reused.
• kodex flag forwarding: any flags forwarded to kodex replace its default bootstrap prompt.
• If the user gave a directory, launch via direnv exec <dir> klaude handoff -n "<slug>" (or kodex …) — do not try to cd.

Report

After launch, report (take the session name from klaude/kodex's own stderr output — names are sanitized, so never re-derive it yourself; say "reused existing session" if it attached to one):

Session started
  Target : claude|codex
  Dir    : <work_dir>
  zellij : <slug>
  Attach : klaude -n "<slug>" | kodex -n "<slug>"
  Raw    : zellij attach "<slug>"