Session Share

What it does

When your agent uses it

• User mentions share session
• Send session to
• Continue from colleague
• Export current session to file

Example prompts

• “share session”
• “export session”
• “import session”
• “/session-share”

Requirements

• A Bash shell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Working in agent-deck session on a feature
2. 2Needs to hand off to Developer B
3. 3Runs: $SKILL_DIR/scripts/export.sh
4. 4Gets file: ~/session-shares/session-2024-01-20-feature.json
5. 5Sends file to Developer B via Slack DM, email, or AirDrop

What it can do on your machine

Read from SKILL.md and the folder at commit 34cf369. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 4 files in scripts/ (Shell), which the agent can run.

  Shell commands in SKILL.md call:

  • brew
  • claude

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Session Share loads about 1.6k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 515 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~92

When it runs · the whole SKILL.md, loaded when a task matches

~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from asheshgoplani/agent-deck at commit 34cf369, republished under its MIT licence (© asheshgoplani). 515 words, ~1,630 tokens.

name

session-share

description

Share Claude Code sessions between developers. Use when user mentions "share session", "export session", "import session", "send session to", "continue from colleague", or needs to (1) export current session to file, (2) import session from another developer, (3) hand off work context. Enables private, secure session transfer via direct file sharing.

metadata.compatibility

claude, opencode

Base directory for this skill: /path/to/.../skills/session-share

# Set SKILL_DIR to the base directory shown when this skill was loaded
SKILL_DIR="/path/shown/in/base-directory-line"

# Then run scripts as:
$SKILL_DIR/scripts/export.sh
$SKILL_DIR/scripts/import.sh ~/Downloads/session-file.json

# Export current session
$SKILL_DIR/scripts/export.sh
# Output: ~/session-shares/session-2024-01-20-my-feature.json

# Share the file via Slack, email, AirDrop, etc.

# Other developer imports
$SKILL_DIR/scripts/import.sh ~/Downloads/session-2024-01-20-my-feature.json
# Session appears in agent-deck, ready to continue

$SKILL_DIR/scripts/export.sh [options]

# Export current session
$SKILL_DIR/scripts/export.sh

# Export to specific location
$SKILL_DIR/scripts/export.sh --output /tmp/handoff.json

# Export specific session with thinking blocks
$SKILL_DIR/scripts/export.sh --session abc123 --include-thinking

$SKILL_DIR/scripts/import.sh <file-path> [options]

# Import and start
$SKILL_DIR/scripts/import.sh ~/Downloads/session-feature.json

# Import with custom title
$SKILL_DIR/scripts/import.sh session.json --title "Feature Work from Alice"

# Import without starting
$SKILL_DIR/scripts/import.sh session.json --no-start

{
  "version": "1.0",
  "exported_at": "2024-01-20T15:30:00Z",
  "exported_by": "alice",
  "session": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Feature Implementation",
    "original_project": "/Users/alice/my-project"
  },
  "context": {
    "summary": "Last few user messages for quick context",
    "modified_files": ["src/auth.ts", "src/middleware.ts"]
  },
  "messages": [ /* JSONL records as JSON array */ ],
  "stats": {
    "total_messages": 150,
    "user_messages": 45,
    "assistant_messages": 105
  }
}

© asheshgoplani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts) in skills/session-share of asheshgoplani/agent-deck.

• SKILL.md
• evals/RUNNER.md
• evals/evals.json
• scripts/.gitkeep
• scripts/export.sh
• scripts/import.sh
• scripts/utils.sh
• tests/test_export_895_regression.sh

Open the folder on GitHubat commit 34cf369