claude-sesh/CONTRIBUTING.md

Session explorer for Claude Code - find, search, and resume all your past sessions

# Contributing to claude-sesh

Thanks for your interest in contributing! This project is open to contributions of all kinds.

## Getting Started

```bash
# Clone the repo
git clone https://github.com/abracadabra50/claude-sesh.git
cd claude-sesh

# Install dependencies
npm install

# Build
npm run build

# Run locally
node dist/cli.js list
```

## Development

```bash
# Watch mode (auto-rebuild on changes)
npm run dev

# Run the web dashboard
npm run web

# Run tests
npm test
```

## Pull Requests

1. Fork the repo and create your branch from `main`
2. Make your changes
3. Ensure the build passes (`npm run build`)
4. Submit a PR with a clear description

## Reporting Issues

Found a bug? Have a feature request? [Open an issue](https://github.com/abracadabra50/claude-sesh/issues/new).

---

## Roadmap

Here's what's coming next for claude-sesh:

- **Community Stats (opt-in)** - Anonymous, aggregated benchmarks so you can see how your Claude Code usage compares to others. Fully opt-in, no personal data shared.

- **Session Diff View** - See what changed between sessions in the same project. Track how your codebase evolved over time.

- **Export & Backup** - Export your session history to JSON/CSV for archival or analysis in other tools.

- **Team Dashboards** - Aggregate stats across multiple users for teams using Claude Code together.

- **Claude Desktop Support** - Extend session tracking to Claude Desktop app sessions.

Want to help with any of these? PRs welcome!

---

## Code of Conduct

Be kind. Be respectful. We're all here to build cool stuff.