share

# 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`)](https://cli.github.com/) installed and authenticated
- A GitHub repository to store sessions (public or private)

## Installation

### Quick Install (Recommended)

**One-liner installation:**

```bash
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`)

**Config…