Skip to main content

Getting Started

Installation - Storyline Docs

Install Storyline in under 2 minutes using Claude Code's plugin system or manual installation.

Getting started with Storyline takes just a couple of minutes. Choose your preferred installation method below.

Prerequisites

Storyline requires Claude Code and works on:

  • Linux
  • macOS
  • WSL (Windows Subsystem for Linux)
  • Windows (native support available, but WSL recommended)

For the best experience:

  • VS Code or compatible IDE with Claude Code integration

Installation Methods

The easiest way to install Storyline is using Claude Code’s built-in plugin system. Simply start a Claude Code session and run one of the following:

Custom Marketplace (Available Now)

/plugin marketplace add https://github.com/prillcode/storyline
/plugin install storyline
/sl-setup check

Official Marketplace (Pending Approval)

Once Storyline is approved for the official Claude plugins marketplace, you’ll be able to install it directly:

/plugin marketplace add anthropics/claude-plugins-official
/plugin install storyline
/sl-setup check

The plugin installation automatically handles all dependencies and sets up Storyline skills and commands in your Claude Code environment.

Option 2: Manual Installation

If you prefer more control or want to inspect the installation scripts, you can install manually:

Linux/macOS/WSL

git clone https://github.com/prillcode/storyline.git
cd storyline
chmod +x install.sh
./install.sh

Windows (PowerShell)

git clone https://github.com/prillcode/storyline.git "$env:USERPROFILE\.local\share\storyline"
cd "$env:USERPROFILE\.local\share\storyline"
.\windows-install.cmd

Security Note: You can inspect the installation scripts before running them. The scripts copy Storyline skills and commands to your ~/.claude/ directories and install bundled dependencies.

What Gets Installed

During installation, Storyline:

  1. Installs bundled cc-resources dependencies
  2. Copies Storyline skills to ~/.claude/skills/
  3. Copies Storyline commands to ~/.claude/commands/

Verify Installation

Start a new Claude Code session and run:

/sl-setup check

This verifies all Storyline components are installed correctly. You should see:

✅ All Storyline skills installed
✅ All Storyline commands installed
✅ All dependencies installed

Updating Storyline

If installed via Plugin

The plugin system will notify you of available updates. Follow the prompts to update automatically.

If installed manually

Navigate to your cloned repository and pull the latest changes:

Linux/macOS/WSL:

cd /path/to/storyline
git pull origin main
./install.sh

Windows:

cd "$env:USERPROFILE\.local\share\storyline"
git pull origin main
.\windows-install.cmd

Initial Setup

Once installation is verified, initialize your first project:

/sl-setup init

This creates the .storyline/ directory structure in your project for managing workflow artifacts including epics, stories, specs, and plans.

Next Steps

Now that Storyline is installed and initialized:

  1. Follow the Quick Start guide to create your first epic
  2. Learn the complete workflow: Workflow documentation
  3. Explore all available commands: Commands reference

Troubleshooting

”Command not found: /sl-setup”

Make sure you started a new Claude Code session after installation. Skills and commands are loaded when Claude Code starts.

Skills not found

Check that files were copied correctly:

ls ~/.claude/skills/storyline*
ls ~/.claude/commands/sl-*

You should see multiple Storyline-related files in each directory.

Permission issues

If you get permission errors during installation:

chmod +x install.sh
./install.sh

WSL Installation Issues

If you’re on Windows and having trouble with WSL:

  1. Ensure WSL 2 is installed: wsl --version
  2. Install a Linux distro: wsl --install -d Ubuntu
  3. Update WSL: wsl --update

Still stuck? Open an issue on GitHub or ask in Discussions.

Next: Quick Start →