CLI Reference

Complete reference for Sessions CLI commands.

sync

sessions sync Auth Required

Upload Claude Code session files to the cloud. Automatically finds .jsonl files from your Claude projects directory.

sessions sync [path] [--dry-run] [--url <url>]

path Directory or file to sync (default: ~/.claude/projects)

--dry-run Show what would be uploaded without uploading

sessions transcript

Parse and display a session transcript in a readable format.

sessions transcript <file> [--json]

file Path to .jsonl session file

--json Output as JSON instead of formatted text

sessions projects Auth Required

List all your Sessions projects.

sessions projects

sessions project Auth Required

Link the current directory to a Sessions project. Creates a .sessions file.

sessions project <name> [--create]

name Project name to link to

--create Create the project if it doesn't exist

sessions rules Auth Required

Show rules for the linked project or a specified project.

sessions rules [project-id]

sessions improve Auth Required

Add a rule to the current project. If no project is linked, adds to incoming suggestions.

sessions improve "<rule>"

sessions global Auth Required

Add a rule to your global profile. Global rules apply across all projects.

sessions global "<rule>"

sessions plugin

Install or update the Claude Code plugin.

sessions plugin [install]

sessions update

Update the Sessions CLI to the latest version.

sessions update