README
¶
sharetoai-cli
The command-line companion to Share to AI — pushes a local Claude Code terminal session to a one-time viewing link, without ever uploading anything until you explicitly run it.
Selection happens entirely on your machine: the CLI finds the most recent Claude Code session file for the current project, lets you pick if more than one was recently active, and sends only that one conversation. The backend holds it in memory for at most 10 minutes and deletes it after the first view — nothing is ever written to a permanent database.
Install
curl -fsSL https://sharetoai.app/install.sh | sh
Or with Go installed:
go install github.com/bahaeddinmselmi/sharetoai-cli@latest
The binary installs as sharetoai.
Usage
# 1. Generate a CLI API key from https://sharetoai.app/account
# ("CLI API key" section), then store it locally:
sharetoai login
# 2. From inside any project directory with a Claude Code session:
sharetoai push
push prints the resulting one-time link and opens it in your default
browser.
How it finds a session
Claude Code stores sessions at ~/.claude/projects/<sanitized-cwd>/*.jsonl,
where the directory name is your project's absolute path with \, /, and
: replaced by -. The CLI computes that directory from your current
working directory; if the guess doesn't match anything, it falls back to
scanning every project directory and matching each session file's own
embedded cwd field instead.
Only Claude Code sessions are supported today.
What this CLI does not do
It doesn't read or upload anything beyond the one session file you're pushing — no bulk scanning, no background sync. The actual conversation extraction logic (for ChatGPT/Claude/Gemini share links) lives entirely in Share to AI's backend and isn't part of this repo.
License
MIT
Documentation
¶
Overview ¶
Command sharetoai is the CLI for Share to AI's zero-retention handoff flow: it finds a local Claude Code session file, serializes only the conversation the user picks, and pushes it to a one-time viewing link. Nothing is scanned or uploaded in bulk — selection happens entirely on this machine before any network call is made.
Source Files