Installation

Install CatalystRL skills and set up your private data directory.

Quick Install

Run the setup script directly from the repository:

curl -fsSL https://raw.githubusercontent.com/tomcatalyst0/catalystrl-claude/main/setup.sh | bash

Safe to run multiple times. Will not overwrite existing data.

What the Installer Does

1. Installs the Repository

Clones catalystrl-claude to ~/.claude

If ~/.claude already exists, it preserves your files and initializes git.

2. Creates Private Data Directory

Sets up ~/claude-data for your private files:

~/claude-data/
├── memory/           # Cross-session memory
├── operational/      # Skill working directories
├── experimental/     # Experimental features
└── platform/         # CatalystRL integration

3. Creates Symlinks

Links operational directories from the repo to your private data directory, so your data stays separate from the open-source code.

4. Configures Settings

Installs settings.json with gate system hooks and skill permissions enabled.

Manual Installation

Prefer to install manually? Follow these steps:

1. Clone the repository

git clone https://github.com/tomcatalyst0/catalystrl-claude.git ~/.claude

2. Run setup

cd ~/.claude && ./setup.sh

3. Configure environment

cp ~/.claude/.env.example ~/claude-data/.env
# Edit ~/claude-data/.env with your settings

Directory Structure

After installation, you'll have two directories:

~/.claude

Open source (version controlled)

• Skills and configurations
• Shared libraries
• Gate enforcement hooks
• ABES evolvers

~/claude-data

Private (your data)

• Cross-session memory
• Todo lists and active work
• Environment variables
• Operational state

Operational Directories

These directories are symlinked from ~/.claude to ~/claude-data/operational:

Directory	Purpose
`state/`	Gate approvals and operational state
`plans/`	Plan mode working files
`handoffs/`	Session handoff documents
`events/`	Telemetry and event logs
`todos/`	Todo archives
`ui-ux/`	Screenshots and visual analysis

Verify Installation

Check that everything is set up correctly:

# Check skills are installed
ls ~/.claude/skills/

# Check memory directory
ls ~/.claude/memory/

# Check symlinks
ls -la ~/.claude/state

You should see the skills directory populated and state pointing to your data directory.

Updating

Pull the latest changes from the repository:

cd ~/.claude && git pull origin main

Your private data in ~/claude-data remains untouched.

Next Steps

Now that CatalystRL is installed, learn how to use the core skills.

Getting Started →Browse Skills →