Installazione

Installazione rapida (Linux / macOS)

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

Questo scarica l’ultimo binario della release per la tua piattaforma, verifica il checksum SHA256 e lo posiziona in ~/.local/bin/.

Dopo l’installazione, inizializza PRECC:

precc init

precc init registra il PreToolUse hook con Claude Code, crea le directory dati e inizializza il database delle skill.

Opzioni di installazione

Verifica SHA256

Per impostazione predefinita, l’installer verifica il checksum del binario rispetto alla somma SHA256 pubblicata. Per saltare la verifica (non raccomandato):

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

Prefisso di installazione personalizzato

Installa in una posizione personalizzata:

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.

Strumenti companion (–extras)

PRECC include strumenti companion opzionali. Installali con --extras:

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

Questo installa:

Windows (PowerShell)

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

Poi inizializza:

precc init

Installazione manuale

1. Scarica il binario della release per la tua piattaforma da GitHub Releases.
2. Verifica il checksum SHA256 rispetto al file .sha256 nella release.
3. Posiziona il binario in una directory nel tuo PATH (es. ~/.local/bin/).
4. Esegui precc init.

Aggiornamento

precc update

Forza l’aggiornamento a una versione specifica:

precc update --force --version 0.3.0

Abilita gli aggiornamenti automatici:

precc update --auto

Installazione sotto OpenClaw / ClawHub

PRECC include un manifest di plugin in plugins/openclaw/openclaw.plugin.json (id precc-token-saver). Quando viene pubblicata una release pubblica, il workflow GitHub Actions clawhub-publish.yml invia il bundle di skill al registro ClawHub, in modo che gli utenti finali possano installare PRECC tramite la CLI di ClawHub anziché tramite l’installer curl:

# ClawHub CLI
clawhub install precc

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

Come appaiono i risparmi sotto OpenClaw

Ogni superficie di reportistica PRECC che funziona sotto Claude Code funziona anche sotto OpenClaw — precc savings, precc savings --all, la riga di stato localizzata (imposta PRECC_LANG=zh e la riga viene visualizzata nella tua lingua) e il log di audit locale delle riscritture leggono tutti dagli stessi database SQLCipher sulla tua macchina. Una specifica separata in docs/symposium-plan/openclaw-savings-reporting.md descrive un futuro campo strutturato preccSavings in ogni risposta hook più una notifica di fine sessione su una riga con soglia predefinita di $0.05; quella parte non è ancora rilasciata.

Verifica dell’installazione

$ precc --version
precc 0.3.0

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

Se precc non viene trovato, assicurati che ~/.local/bin sia nel tuo PATH.