Installation

Installation rapide (Linux / macOS)

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

Cela télécharge le dernier binaire pour votre plateforme, vérifie la somme de contrôle SHA256 et le place dans ~/.local/bin/.

Après l’installation, initialisez PRECC :

precc init

precc init enregistre le hook PreToolUse avec Claude Code, crée les répertoires de données et initialise la base de données des compétences.

Options d’installation

Vérification SHA256

Par défaut, l’installateur vérifie la somme de contrôle du binaire par rapport à la somme SHA256 publiée. Pour ignorer la vérification (non recommandé) :

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

Préfixe d’installation personnalisé

Installer dans un emplacement personnalisé :

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.

Outils compagnons (–extras)

PRECC est livré avec des outils compagnons optionnels. Installez-les avec --extras :

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

Cela installe :

Windows (PowerShell)

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

Puis initialisez :

precc init

Installation manuelle

1. Téléchargez le binaire pour votre plateforme depuis GitHub Releases.
2. Vérifiez la somme de contrôle SHA256 par rapport au fichier .sha256 de la version.
3. Placez le binaire dans un répertoire de votre PATH (par ex., ~/.local/bin/).
4. Exécutez precc init.

Mise à jour

precc update

Forcer la mise à jour vers une version spécifique :

precc update --force --version 0.3.0

Activer les mises à jour automatiques :

precc update --auto

Installation sous OpenClaw / ClawHub

PRECC fournit un manifeste de plugin dans plugins/openclaw/openclaw.plugin.json (id precc-token-saver). Lorsqu’une version publique est publiée, le workflow GitHub Actions clawhub-publish.yml pousse le bundle de skills vers le registre ClawHub, afin que les utilisateurs finaux puissent installer PRECC via la CLI ClawHub plutôt que via l’installateur 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.

Comment les économies apparaissent sous OpenClaw

Toutes les surfaces de reporting PRECC qui fonctionnent sous Claude Code fonctionnent aussi sous OpenClaw — precc savings, precc savings --all, la ligne de statut localisée (définissez PRECC_LANG=zh et la ligne s’affiche dans votre langue), ainsi que le journal d’audit local des réécritures lisent toutes depuis les mêmes bases de données SQLCipher sur votre machine. Une spécification distincte dans docs/symposium-plan/openclaw-savings-reporting.md décrit un futur champ structuré preccSavings dans chaque réponse de hook plus une notification de fin de session sur une ligne avec un seuil par défaut de $0.05 ; cette partie n’est pas encore livrée.

Vérification de l’installation

$ precc --version
precc 0.3.0

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

Si precc n’est pas trouvé, assurez-vous que ~/.local/bin est dans votre PATH.