Beta pública · v0.8

Documentação

O Simplicio é uma CLI local-first que corta até 90% dos tokens por tarefa em qualquer LLM. Esta página cobre instalação, primeiro uso, comandos e integração com seus editores.

Instalação

Um comando. Baixa o binário, ativa a integração com o Claude (skill + hook), registra o MCP nos seus editores e mapeia o projeto atual.

macOS / Linux

curl -fsSL simpleti.com.br/simplicio/install.sh | sh

Windows (PowerShell)

irm simpleti.com.br/simplicio/install.ps1 | iex

Via GitHub

curl -fsSL raw.githubusercontent.com/wesleysimplicio/simplicio/main/install.sh | sh

Opções do instalador:

--no-claude — instala só o binário, sem skill/hook do Claude.
--with-claude — força a integração completa (padrão).

O binário fica em ~/.local/bin/simplicio. Se o comando não for encontrado, adicione ao PATH: export PATH="$HOME/.local/bin:$PATH".

Guia de início

Depois de instalar, em menos de 2 minutos:

Verifique a instalação:
```
simplicio version
```
Entre no seu projeto e mapeie:
```
cd meu-projeto
simplicio onboard
```
Mapeia o repositório e aquece a memória neural — a partir daqui a economia já está ativa.
Converse e execute:
```
simplicio
```
Abre o chat. Peça qualquer coisa ("crie um endpoint de login e teste até passar"); ele interpreta, age com confirmação e mostra a economia no fim de cada resposta.
Veja quanto economizou:
```
simplicio savings
```

Como funciona

O Simplicio fica entre você e a LLM e elimina os gastos desnecessários:

Mapa, não despejo — runtime map entrega um mapa comprimido do repo no lugar de arquivos crus.
Memória, não repetição — decisões anteriores ficam na memória neural e voltam por consulta, sem reenvio de contexto.
Edição zero-token — a mudança decidida é aplicada mecanicamente; o modelo não gasta token escrevendo arquivo.
Local primeiro — tarefas mecânicas rodam em agentes locais (64 → 600); o modelo pago é o último recurso.
Portão + evidência — toda ação passa por classificação de risco e fica registrada num lacre verificável, com checkpoint/undo.

Comandos

Comando	O que faz
`simplicio`	Abre o chat que interpreta e executa.
`simplicio onboard`	Mapeia o projeto e ativa a economia no repo atual.
`simplicio runtime map --repo . --for-llm markdown`	Mapa comprimido do repo pra LLM.
`simplicio memory "<consulta>" --repo .`	Recupera decisões anteriores da memória neural.
`simplicio edit '{…}'`	Edição mecânica de arquivos — zero token do modelo.
`simplicio gate classify --action "…"`	Classifica o risco de uma ação antes de mutar.
`simplicio checkpoint`	Cria ponto de restauração (undo de ações).
`simplicio deliver`	Só declara "entregue" quando roda e passa nos critérios.
`simplicio savings`	Relatório de tokens economizados.
`simplicio mcp register`	Registra o Simplicio como ferramenta MCP nos editores.
`simplicio update`	Atualiza pro último release assinado.
`simplicio --help`	Lista completa de comandos.

Claude e editores (MCP)

O instalador já ativa tudo, mas dá pra fazer manualmente:

Claude Code (skill + hook sempre-on)

A skill instala em ~/.claude/skills/simplicio/ e o hook de sessão em ~/.claude/hooks/. Toda sessão do Claude começa em "modo Simplicio": a IA orienta pelo runtime e corta tokens sem você pedir.

MCP em 9 editores

simplicio mcp register

Registra o Simplicio como ferramenta nativa no Claude, Cursor, Codex, Zed, VS Code, JetBrains e outros. As ferramentas expostas: simplicio_map, simplicio_memory, simplicio_edit, simplicio_gate, simplicio_validate.

Modelos remotos (opcional)

# aponte pra qualquer provedor OpenAI-compatible
export SIMPLICIO_MODEL="…"
export SIMPLICIO_BASE_URL="…"
export SIMPLICIO_API_KEY="…"

Sem essas variáveis, ele roda 100% local (modelo embutido via llama.cpp) — custo zero de token.

Relatório de economia

simplicio savings

Mostra, por interação e acumulado, os tokens gastos × o que custaria sem o Simplicio. Cada resposta do chat também termina com a linha de economia:

Simplicio: ~3k tokens · sem Simplicio ~12k · economia ~9k (75%)

Atualizar

simplicio update

Baixa o último release do canal assinado (ed25519). Binários não assinados são recusados. Pra checar a instalação: simplicio update doctor.

Desinstalar

rm ~/.local/bin/simplicio
rm -rf ~/.claude/skills/simplicio ~/.claude/hooks/simplicio-*.sh

Remova também as entradas simplicio-session-start / simplicio-enforce de ~/.claude/settings.json se quiser limpar os hooks.

FAQ

É grátis?

Durante a beta pública, sim — tudo liberado. Depois, US$ 10/mês. Cancele quando quiser.

Funciona com qual LLM?

Qualquer uma: Claude, GPT, Gemini, Kimi, Qwen, DeepSeek e qualquer endpoint OpenAI-compatible. Também roda 100% local sem nenhuma chave.

Meu código sai da minha máquina?

Não pelo Simplicio. Mapa, memória, edição e validação rodam localmente. Só vai pra LLM o que você já enviaria — só que muito menos.

Preciso de GPU?

Não. Em Apple Silicon ele usa Metal automaticamente; em qualquer máquina roda em CPU.

Achei um bug na beta.

Mande pra wesley@simpleti.com.br ou abra issue no GitHub.