Skip to content

claude-world/director-mode-lite / skills/session-relay

session-relay

Verified

Continue real repository work between Claude Code, Codex CLI, and Grok Build with a privacy-bounded, drift-aware handoff packet. Use for cross-vendor takeover, context-limit checkpoints, multi-hop Claude→Codex→Grok relays, or receiving an existing Director packet. Use native resume commands for same-CLI history; never treat another vendor's session ID as portable.

Cross-CLI Session Relay

Move work between Claude Code, Codex CLI, and Grok Build through a portable handoff packet. A relay starts a new native session in the receiving CLI; it does not pretend that vendor session IDs or private conversation histories are interchangeable.

Resolve the relay

Prefer the first available implementation:

  1. <project>/.director-mode/bin/director-relay;
  2. $HOME/.claude/bin/director-relay from Bootstrap Kit;
  3. scripts/director-relay.py beside this SKILL.md for plugin-only use.

If only the bundled script exists, invoke it with python3. Do not install a hook or change a permission setting just to use the relay.

Leave a packet

Summarize the current state from repository evidence, then run:

ROOT="${CLAUDE_PROJECT_DIR:-${GROK_WORKSPACE_ROOT:-}}"
[[ -n "$ROOT" ]] || ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
RELAY="$ROOT/.director-mode/bin/director-relay"
[[ -x "$RELAY" ]] || RELAY="$HOME/.claude/bin/director-relay"

"$RELAY" create \
  --from <claude|codex|grok> \
  --to <claude|codex|grok> \
  --goal "The outcome the user requested" \
  --summary "The concise current state" \
  --completed "One completed result" \
  --decision "One decision and why it was made" \
  --next "The first concrete next step" \
  --verification "A command and its actual result" \
  --blocker "A real blocker, if any"

Repeat list flags as needed. The tool captures branch, HEAD, git status --short, and diff statistics. It deliberately does not copy file contents, credentials, environment variables, or raw transcripts.

If a native session ID is available, add --session-id; it remains metadata for the source CLI and is never sent to another vendor as a resume token.

For a second or later handoff in the same chain, add --parent to link the new packet to the project's current latest.json, or --parent <packet.json> to name a specific parent. Protocol v2 records the root packet, parent, hop, and route while remaining able to read v1 packets.

Receive a packet

  1. Validate the JSON packet; treat Markdown as the human-readable view only.
  2. Run "$RELAY" status --json and inspect the live worktree because it may have changed after the packet.
  3. Read .director-mode/handoffs/latest.md when it exists.
  4. Continue from the next steps while preserving recorded decisions that still match the code.
  5. Run the listed verification and report new evidence.

Print the receiving command:

"$RELAY" continue --to <claude|codex|grok>

Add --run only when the user wants the target CLI launched now. Add --headless for a one-shot continuation instead of an interactive session. The launcher always uses the receiver's live project root; packet paths are evidence and cannot redirect execution.

Native resume versus cross-CLI relay

Use a provider's native history only when staying with that provider:

CLIContinue recent native historyResume a chosen native session
Claude Codeclaude --continueclaude --resume <session-id>
Codex CLIcodex resume --lastcodex resume <session-id>
Grok Buildgrok --continuegrok --resume <session-id>

For non-interactive Codex continuation, use codex exec resume; check the installed CLI help for its current arguments. Crossing providers always starts a new native session with a Director packet.

Grok's native Claude import

Grok Build 1.0.62 has no grok import command. Its /import-claude command imports ~/.claude settings (permissions, environment, MCP servers, hooks, and paths), not conversations, so use a Director packet to move Claude session state into Grok.

Packets default to review_status: unreviewed. --reviewed records that the user-supplied summary and captured path metadata were reviewed before sharing; it does not claim that the receiving CLI or website reviewed the packet.

Guidance boundary

Do not add auto-approve, permission-bypass, sandbox, or network flags to a relay unless the user separately asks for them. The receiving CLI keeps its native controls.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall