Quick Start

Get up and running in 5 minutes.

1. Link Your First Project

Navigate to a project directory and link it to Sessions. In Claude Code, run:

Claude Code

/project myproject

This creates a .sessions file in your directory. If the project doesn't exist, add --create to create it.

2. Add Your First Rule

While working, notice something Claude should remember? Capture it:

Claude Code

/improve "Always use early returns instead of nested if statements"

The rule is added to your linked project and will load automatically in future sessions.

3. Add a Global Rule

For preferences that apply to all your projects:

Claude Code

/global "Never add comments unless I ask for them"

Global rules load for every session, regardless of which project you're working in.

4. Review Suggestions

If you use /improve without a linked project, rules go to your inbox. Visit the dashboard to review:

					URL
				
sessions.shotgun.dev/dashboard/projects?type=incoming

Approve suggestions to turn them into active rules, or reassign them to specific projects.

5. See It in Action

Start a new Claude Code session in your linked project. Your rules are loaded automatically via the MCP integration. Check the current rules anytime:

bash

sessions rules

The /project, /improve, and /global commands are slash commands that work inside Claude Code. The equivalent CLI commands are sessions project, sessions improve, and sessions global.

Previous Installation Next CLI Reference