Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

Quick Install (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/peria-ai/precc-cc/main/scripts/install.sh | bash

This downloads the latest release binary for your platform, verifies the SHA256 checksum, and places it in ~/.local/bin/.

After installation, initialize PRECC:

precc init

precc init registers the PreToolUse hook with Claude Code, creates the data directories, and initializes the skills database.

Install Options

SHA256 Verification

By default, the installer verifies the binary checksum against the published SHA256 sum. To skip verification (not recommended):

curl -fsSL https://raw.githubusercontent.com/peria-ai/precc-cc/main/scripts/install.sh | bash -s -- --no-verify

Custom Install Prefix

Install to a custom location:

curl -fsSL https://raw.githubusercontent.com/peria-ai/precc-cc/main/scripts/install.sh | bash -s -- --prefix /opt/precc

Companion Tools (–extras)

PRECC ships with optional companion tools. Install them with --extras:

curl -fsSL https://raw.githubusercontent.com/peria-ai/precc-cc/main/scripts/install.sh | bash -s -- --extras

This installs:

ToolPurpose
RTKCommand rewriting toolkit
lean-ctxContext compression for CLAUDE.md and prompt files
nushellStructured shell for advanced pipelines
cocoindex-codeCode indexing for faster context resolution

Windows (PowerShell)

irm https://raw.githubusercontent.com/peria-ai/precc-cc/main/scripts/install.ps1 | iex

Then initialize:

precc init

Manual Install

  1. Download the release binary for your platform from GitHub Releases.
  2. Verify the SHA256 checksum against the .sha256 file in the release.
  3. Place the binary in a directory on your PATH (e.g., ~/.local/bin/).
  4. Run precc init.

Updating

precc update

Force update to a specific version:

precc update --force --version 0.3.0

Enable automatic updates:

precc update --auto

Verifying Installation

$ precc --version
precc 0.3.0

$ precc savings
Session savings: 0 tokens (no commands intercepted yet)

If precc is not found, ensure ~/.local/bin is on your PATH.