session-share

📁 asheshgoplani/agent-deck 📅 8 days ago

总安装量

周安装量

#52712

全站排名

安装命令

npx skills add https://github.com/asheshgoplani/agent-deck --skill session-share

Agent 安装分布

replit 1

opencode 1

codex 1

claude-code 1

gemini-cli 1

Skill 文档

Session Share

Share Claude Code sessions between developers through portable file export/import.

Version: 1.0 | Privacy: Files are never uploaded to cloud unless you choose to share them

Quick Start

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

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

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

Commands

Export Session

Export the current Claude session to a portable file:

scripts/export.sh [options]

Options:

Option	Description
`--session <id>`	Export specific session (default: current)
`--output <path>`	Custom output path
`--include-thinking`	Include Claude’s thinking blocks
`--no-sanitize`	Don’t redact sensitive data

Examples:

# Export current session
scripts/export.sh

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

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

What gets exported:

All conversation messages (user and assistant)
Tool calls and results
File modifications tracked
Session metadata

What gets redacted (by default):

API keys and tokens
Absolute paths (converted to relative)
Thinking blocks (Claude’s internal reasoning)

Import Session

Import a shared session file and create an agent-deck session:

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

Options:

Option	Description
`--title <name>`	Override session title
`--project <path>`	Import to specific project
`--no-start`	Don’t auto-start the session

Examples:

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

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

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

Workflow: Sharing a Session

Developer A (Exporter)

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

Developer B (Importer)

Receives the session file
Runs: scripts/import.sh ~/Downloads/session-2024-01-20-feature.json
Session appears in agent-deck as “Imported: feature”
Starts session – Claude has full context from Developer A’s work
Continues where Developer A left off

Export File Format

{
  "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
  }
}

Security & Privacy

What’s Redacted by Default

Data Type	Redaction
API keys	Replaced with `[REDACTED]`
Tokens	Replaced with `[REDACTED]`
Home paths	Converted to `~`
Username in paths	Converted to `$USER`
Thinking blocks	Removed entirely

Best Practices

Review before sharing – Open the export file and scan for sensitive data
Use direct transfer – Slack DM, email, AirDrop are more private than cloud links
Delete after import – Remove the file once imported successfully
Use --include-thinking sparingly – Thinking blocks may contain sensitive reasoning

Troubleshooting

Issue	Solution
“Could not detect current Claude session”	Make sure you’re in an agent-deck session with active Claude
“Session file not found”	Session may not have been saved yet; send a message first
Import shows wrong project	Use `--project /correct/path` to specify destination
Large file size	Use default settings (strips thinking blocks)

Technical Details

Session Storage

Claude stores sessions in: ~/.claude/projects/<encoded-path>/<session-id>.jsonl

Path encoding: /Users/alice/project becomes -Users-alice-project

How Import Works

Reads export JSON file
Creates directory: ~/.claude/projects/<encoded-current-project>/
Writes messages as JSONL: <session-id>.jsonl
Creates agent-deck session pointing to this path
Sets claude-session-id so restart uses --resume

Dependencies

jq – JSON processing (install: brew install jq)
agent-deck – Session management
claude – Claude Code CLI

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台