Instalación

Instalación rápida (Linux / macOS)

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

Esto descarga el binario de la última versión para su plataforma, verifica la suma de comprobación SHA256 y lo coloca en ~/.local/bin/.

Después de la instalación, inicialice PRECC:

precc init

precc init registra el hook PreToolUse con Claude Code, crea los directorios de datos e inicializa la base de datos de habilidades.

Opciones de instalación

Verificación SHA256

Por defecto, el instalador verifica la suma de comprobación del binario contra la suma SHA256 publicada. Para omitir la verificación (no recomendado):

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

Prefijo de instalación personalizado

Instalar en una ubicación personalizada:

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.

Herramientas complementarias (–extras)

PRECC incluye herramientas complementarias opcionales. Instálelas con --extras:

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

Esto instala:

Windows (PowerShell)

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

Luego inicialice:

precc init

Instalación manual

1. Descargue el binario de lanzamiento para su plataforma desde GitHub Releases.
2. Verifique la suma de comprobación SHA256 contra el archivo .sha256 del lanzamiento.
3. Coloque el binario en un directorio de su PATH (p. ej., ~/.local/bin/).
4. Ejecute precc init.

Actualización

precc update

Forzar la actualización a una versión específica:

precc update --force --version 0.3.0

Habilitar actualizaciones automáticas:

precc update --auto

Instalación con OpenClaw / ClawHub

PRECC incluye un manifiesto de plugin en plugins/openclaw/openclaw.plugin.json (id precc-token-saver). Cuando se publica una versión pública, el flujo de trabajo de GitHub Actions clawhub-publish.yml envía el paquete de skills al registro de ClawHub, de modo que los usuarios finales pueden instalar PRECC mediante la CLI de ClawHub en lugar del instalador 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.

Cómo se muestran los ahorros en OpenClaw

Toda superficie de informes de PRECC que funciona en Claude Code también funciona en OpenClaw: precc savings, precc savings --all, la línea de estado localizada (defina PRECC_LANG=zh y la línea se renderiza en su idioma) y el registro local de auditoría de reescrituras leen de las mismas bases de datos SQLCipher en su máquina. Una especificación independiente en docs/symposium-plan/openclaw-savings-reporting.md describe un futuro campo estructurado preccSavings en cada respuesta del hook más una notificación de una línea al final de la sesión con un umbral predeterminado de $0.05; esa parte aún no está disponible.

Verificación de la instalación

$ precc --version
precc 0.3.0

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

Si precc no se encuentra, asegúrese de que ~/.local/bin esté en su PATH.