Claude Code Session Sharing Plugin
A Claude Code plugin that saves and shares your coding sessions to GitHub repositories in readable markdown format.
Features
- Converts JSONL session logs to clean, readable markdown
- Automatically commits and pushes to any GitHub repository
- Organizes sessions by username in configurable directory structure
- Supports optional session descriptions
- Collapses tool usage details by default for cleaner reading
- Fully configurable via environment variables
Prerequisites
- Python 3.6+
- GitHub CLI (
gh) installed and authenticated
- A GitHub repository to store sessions (public or private)
Installation
Quick Install (Recommended)
One-liner installation:
curl -fsSL https://raw.githubusercontent.com/PostHog/claude-code-share-plugin/main/install.sh | \
bash -s -- --claude-share-repo repo-owner/repo-name
Replace repo-owner/repo-name with your sessions repository.
What gets auto-detected:
- GitHub username (from
gh CLI)
- Current session log (from
~/.claude/projects/ based on working directory)
- Branch (defaults to
main)
- Path (defaults to
sessions/claude)
Configuration is saved automatically to ~/.claude/share-plugin-config.json during installation - no environment variables needed!
Manual Installation
Option 1: Install from GitHub
In Claude Code, run:
/plugin marketplace add PostHog/claude-code-share-plugin
/plugin install share@claude-code-share-plugin
Option 2: Install locally
Clone the repository:
gh repo clone PostHog/claude-code-share-plugin ~/claude-plugins/claude-code-share-plugin
In Claude Code:
/plugin marketplace add ~/claude-plugins/claude-code-share-plugin
/plugin install share@claude-code-share-plugin
Manual Configuration (Optional)
The Quick Install automatically saves configuration to ~/.claude/share-plugin-config.json.
If you need to change the repository later, you can either:
- Re-run the installer with a new repo
- Edit the config file directly:
cat > ~/.claude/share-plugin-config.json <<EOF
{
"repo": "new-owner/new-repo"
}
EOF
- Use environment variable (takes precedence over config file):
export CLAUDE_SHARE_REPO="repo-owner/repo-name"
Team/Project Configuration (Optional)
For automatic plugin installation across your team, add to your project's .claude/settings.json:
{
"extraKnownMarketplaces": {
"claude-code-share-plugin": {
"source": {
"source": "github",
"repo": "PostHog/claude-code-share-plugin"
}
}
},
"enabledPlugins": [
"share@claude-code-share-plugin"
]
}
When team members trust the repository, Claude Code will automatically install the marketplace and plugin.
Usage
Basic usage
Share the current session with no description:
/share
With description
Share with a descriptive name:
/share fixing authentication bug
This creates a file like: 20251021-142530-fixing-authentication-bug.md
Output structure
Sessions are organized as:
your-sessions-repo/
└── sessions/
└── claude/
└── username/ # Auto-detected from gh CLI
├── 20251021-142530-fixing-auth.md
├── 20251021-153245-adding-tests.md
└── ...
Example markdown output
# Claude Code Session
**Date:** 2025-10-21 14:25:30
---
## User
Can you help me fix the authentication bug?
## Claude
I'll help you investigate the authentication issue. Let me first check the relevant files.
<details>
<summary>Tool: read_any_files</summary>
```json
{
"files": [
{
"path": "/src/auth/login.py"
}
]
}
Configuration
| What | How |
|---|
| Configured during install | Repository saved to ~/.claude/share-plugin-config.json |
| Auto-detected | Username (from gh CLI) |
| Auto-detected | Session log (from ~/.claude/projects/ based on working directory) |
| Defaults | Branch: main, Path: sessions |
Troubleshooting
"Error: Repository not configured"
The plugin needs to know which GitHub repository to use. Run the installer:
curl -fsSL https://raw.githubusercontent.com/PostHog/claude-code-share-plugin/main/install.sh | \
bash -s -- repo-owner/repo-name
Or create the config file manually:
cat > ~/.claude/share-plugin-config.json <<EOF
{
"repo": "repo-owner/repo-name"
}
EOF
"Error cloning repository"
Ensure:
- The
gh CLI is installed: gh --version
- You're authenticated:
gh auth status
- You have access to the target repository
- The repository exists
"Error pushing to GitHub"
Check that:
- You have write access to the repository
- The branch exists (or create it first)
- Your authentication hasn't expired:
gh auth refresh
Development
To modify the plugin:
- Edit files in this directory
- Uninstall the old version:
/plugin uninstall share
- Reinstall:
/plugin install share@claude-code-share-plugin
- Test your changes
How It Works
- Reads the current Claude Code session log (JSONL format)
- Parses each message (user/assistant/tool calls)
- Converts to readable markdown with:
- User messages
- Claude responses
- Tool usage in collapsible
<details> sections
- Clones target repo to
/tmp/claude-share-temp
- Creates session file with timestamp and description
- Commits and pushes to GitHub
- Provides direct link to view the session
Privacy & Security
- Session logs may contain sensitive information from your codebase
- Consider using a private repository for session storage
- Review the generated markdown before sharing links publicly
- The plugin uses
gh CLI which respects your existing GitHub authentication
License
MIT
@posthog