Installation

Get Sessions running on your development machine.

Quick Install

Install Sessions with a single command:

bash
curl -fsSL https://sessions.shotgun.dev/install.sh | sh

This installs the CLI to ~/.local/bin and automatically sets up the Claude Code plugin.

If ~/.local/bin isn't in your PATH, add export PATH="$PATH:$HOME/.local/bin" to your shell profile.

Authentication

Most commands require authentication. You have two options:

Browser Authentication (Recommended)

bash
sessions auth

Opens your browser to sign in and create an API key.

Manual API Key

bash
sessions login

Paste an API key from sessions.shotgun.dev/dashboard/keys.

Configuration is stored at ~/.config/sessions/config.json

What's Installed

The install script sets up:

  • sessions CLI - Command-line tool at ~/.local/bin/sessions
  • MCP server configuration - Registered in ~/.claude/.mcp.json
  • Slash commands - /projects, /project, /improve, /global