Installation

Schnellinstallation (Linux / macOS)

curl -fsSL https://peria.ai/install.sh | bash

Dies lädt die neueste Release-Binary für Ihre Plattform herunter, verifiziert die SHA256-Prüfsumme und platziert sie in ~/.local/bin/.

Nach der Installation initialisieren Sie PRECC:

precc init

precc init registriert den PreToolUse-Hook bei Claude Code, erstellt die Datenverzeichnisse und initialisiert die Skills-Datenbank.

Installationsoptionen

SHA256-Verifizierung

Standardmäßig verifiziert der Installer die Binär-Prüfsumme gegen die veröffentlichte SHA256-Summe. Um die Verifizierung zu überspringen (nicht empfohlen):

curl -fsSL https://peria.ai/install.sh | bash -s -- --no-verify

Benutzerdefiniertes Installationspräfix

In ein benutzerdefiniertes Verzeichnis installieren:

curl -fsSL https://peria.ai/install.sh | bash -s -- --prefix /opt/precc

OpenCLI (–opencli) — WebFetch token savings

PRECC can also install OpenCLI, a third-party Node.js tool that turns ~148 websites (HackerNews, Reddit, arxiv, bilibili, zhihu, x.com, …) into structured-output commands. When installed, PRECC’s two built-in webfetch-opencli-* skills auto-rewrite raw curl/wget calls into the corresponding opencli <site> command for 5–50× smaller output.

precc init --opencli

This runs npm install -g @jackwener/opencli (requires Node.js 20+) and prints the URL for OpenCLI’s optional Chrome extension. The extension is only needed to reuse logged-in cookies on private pages; public sources work without it.

Skipping --opencli keeps PRECC fully self-contained — the auto-rewrite skill inlines a command -v opencli check that falls back to the original command when OpenCLI isn’t installed, so the skill is safe to ship default-on.

The Chrome extension requests broad permissions (debugger, <all_urls>, cookies). Operators should review them before installing it; --opencli only handles the npm package, not the extension.

Begleit-Tools (–extras)

PRECC wird mit optionalen Begleit-Tools ausgeliefert. Installieren Sie diese mit --extras:

curl -fsSL https://peria.ai/install.sh | bash -s -- --extras

Dies installiert:

Windows (PowerShell)

irm https://peria.ai/install.ps1 | iex

Dann initialisieren:

precc init

Manuelle Installation

1. Laden Sie die Release-Binary für Ihre Plattform von GitHub Releases herunter.
2. Verifizieren Sie die SHA256-Prüfsumme anhand der .sha256-Datei im Release.
3. Platzieren Sie die Binary in einem Verzeichnis in Ihrem PATH (z.B. ~/.local/bin/).
4. Führen Sie precc init aus.

Aktualisierung

precc update

Erzwinge ein Update auf eine bestimmte Version:

precc update --force --version 0.3.0

Automatische Updates aktivieren:

precc update --auto

Installation unter OpenClaw / ClawHub

PRECC liefert ein Plugin-Manifest unter plugins/openclaw/openclaw.plugin.json (id precc-token-saver) aus. Bei einem öffentlichen Release schiebt der GitHub-Actions-Workflow clawhub-publish.yml das Skill-Bundle in die ClawHub-Registry, sodass Endnutzer PRECC über die ClawHub-CLI statt über den curl-Installer installieren können:

# ClawHub CLI
clawhub install precc

# Or pin the plugin manifest (id: precc-token-saver) via OpenClaw's
# plugin marketplace UI or its CLI equivalent.

Wie Einsparungen unter OpenClaw angezeigt werden

Jede PRECC-Berichtsoberfläche, die unter Claude Code funktioniert, funktioniert auch unter OpenClaw — precc savings, precc savings --all, die lokalisierte Statuszeile (setzen Sie PRECC_LANG=zh und die Zeile erscheint in Ihrer Sprache) und das lokale Rewrite-Audit-Log lesen alle aus denselben SQLCipher-Datenbanken auf Ihrem Rechner. Eine separate Spezifikation unter docs/symposium-plan/openclaw-savings-reporting.md beschreibt ein künftiges strukturiertes preccSavings-Feld in jeder Hook-Antwort sowie eine einzeilige Sitzungsende-Benachrichtigung bei einer Standardschwelle von $0.05; dieser Teil ist noch nicht ausgeliefert.

Installation überprüfen

$ precc --version
precc 0.3.0

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

Wenn precc nicht gefunden wird, stellen Sie sicher, dass ~/.local/bin in Ihrem PATH ist.