Instalação

Instalação rápida (Linux / macOS)

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

Isso baixa o binário da versão mais recente para sua plataforma, verifica a soma de verificação SHA256 e o coloca em ~/.local/bin/.

Após a instalação, inicialize o PRECC:

precc init

precc init registra o hook PreToolUse no Claude Code, cria os diretórios de dados e inicializa o banco de dados de habilidades.

Opções de instalação

Verificação SHA256

Por padrão, o instalador verifica a soma de verificação do binário contra a soma SHA256 publicada. Para pular a verificação (não recomendado):

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

Prefixo de instalação personalizado

Instalar em um local personalizado:

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.

Ferramentas complementares (–extras)

O PRECC inclui ferramentas complementares opcionais. Instale-as com --extras:

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

Isso instala:

Windows (PowerShell)

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

Em seguida, inicialize:

precc init

Instalação manual

1. Baixe o binário de lançamento para sua plataforma em GitHub Releases.
2. Verifique a soma de verificação SHA256 com o arquivo .sha256 da versão.
3. Coloque o binário em um diretório no seu PATH (ex.: ~/.local/bin/).
4. Execute precc init.

Atualização

precc update

Forçar atualização para uma versão específica:

precc update --force --version 0.3.0

Ativar atualizações automáticas:

precc update --auto

Instalação no OpenClaw / ClawHub

O PRECC fornece um manifesto de plugin em plugins/openclaw/openclaw.plugin.json (id precc-token-saver). Quando uma versão pública é publicada, o fluxo de trabalho do GitHub Actions clawhub-publish.yml envia o pacote de skills para o registro do ClawHub, permitindo que os usuários finais instalem o PRECC pela CLI do ClawHub em vez do 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.

Como as economias aparecem no OpenClaw

Toda superfície de relatório do PRECC que funciona no Claude Code também funciona no OpenClaw — precc savings, precc savings --all, a linha de status localizada (defina PRECC_LANG=zh e a linha aparece no seu idioma) e o log local de auditoria de reescritas leem todos das mesmas bases de dados SQLCipher na sua máquina. Uma especificação separada em docs/symposium-plan/openclaw-savings-reporting.md descreve um futuro campo estruturado preccSavings em cada resposta de hook, além de uma notificação de fim de sessão em uma linha com limite padrão de $0.05; essa parte ainda não foi lançada.

Verificando a instalação

$ precc --version
precc 0.3.0

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

Se precc não for encontrado, certifique-se de que ~/.local/bin está no seu PATH.