Cliente de APIs local-first, sem conta e baseado em arquivos. O Reqlivo lê e grava uma coleção em OpenCollection 1.0.0 com extensões extensions.reqlivo, executa HTTP e compartilha o mesmo modelo entre a CLI e a interface desktop Tauri.
Documentação · Contribuir · Reportar problema
Estado atual: MVP funcional com respostas incrementais (0.4.0 publicada). O escopo implementado e as lacunas conhecidas estão em docs/mvp.md e docs/limitacoes.md. A release 0.4.0 foi publicada em 2026-11-02 na tag
v0.4.0, com instaladores Linux/Windows eSHA256SUMS; a 0.3.0 permanece como release anterior. A matriz manual no Windows, a instalação limpa e a auditoria com leitor de tela seguem pendentes. Detalhes em docs/release-0.4.0.md.
- Projeto local com coleção, pastas, requisições, ambientes e configurações.
- HTTP com métodos, query/path params, headers, corpos JSON/texto/XML/SPARQL, formulário e multipart.
- Metadados de resposta: status, headers, corpo, tempo, tamanho, URL final, redirecionamento e truncamento.
- Resposta incremental no envio interativo: headers e corpo aparecem durante a leitura, com contador de bytes, preservação de UTF-8 entre chunks e substituição pela resposta final validada.
- Variáveis com precedência explícita: runtime → requisição → pasta → ambiente (pai→filho) → coleção.
- Autenticação Basic, Bearer e API key (header/query), com herança de pasta e coleção.
- Scripts síncronos de pré-requisição, pós-resposta e testes, com limite de memória/pilha e timeout.
- Asserções declarativas (
runtime.assertions) além dos testes em JavaScript. - Runner local com relatório, filtros, hash determinístico, cancelamento e histórico.
- Importação/exportação de cURL, Postman, OpenCollection e projeto.
- Rascunhos locais com autosave, recuperação de órfãos e guarda de navegação.
- Reconciliação de alterações externas por hash, com recarga assistida e conflito de revisão.
- Lixeira recuperável com restauração por ID, escolha de destino e proteção contra sobrescrita.
- Migrações com inspeção somente-leitura, backup verificável, rollback e tela de recuperação.
- Aplicativo Tauri 2 para Linux e Windows, com IPC local, atalhos e foco visível.
- Segredos por referência (
provider: env) e redaction de logs, relatórios e exportações. - Modo offline real: bloqueia destinos externos e redirecionamentos para fora da rede local.
- Rust estável recente (edição 2024; o crate declara
rust-version = "1.85"). - Desktop: WebKitGTK 4.1 no Linux e WebView2 no Windows. Node.js 22 e npm são usados apenas no desenvolvimento/build.
- Instaladores Linux e Windows e guia desktop/releases.
- Python 3 apenas para o servidor sintético de demonstração/testes manuais.
git clone https://github.com/Andre-Ricardo/reqlivo.git
cd reqlivo
cargo build --release
cargo testCrie uma coleção local:
cargo run -- init --collection minha-api --name "Minha API"
npm ci
npm run desktop:dev -- -- --collection minha-apiO aplicativo abre uma janela nativa. No primeiro uso sem argumentos, cria uma coleção nos dados locais do aplicativo. Use Abrir coleção para selecionar outra pasta. O comando serve foi removido.
O diretório examples/demo contém uma coleção pronta, com pasta, auth herdada, scripts, asserções e um segredo referenciado.
-
Inicie o servidor sintético, em outro terminal:
python3 examples/servidor_demo.py
-
Execute a coleção:
cargo run -- --collection examples/demo validate cargo run -- --collection examples/demo run --env dev
-
Para exercitar o segredo referenciado:
REQLIVO_DEMO_TOKEN=valor-sintetico \ cargo run -- --collection examples/demo run --env seguro
-
Para abrir a demonstração na interface:
npm run desktop:dev -- -- --collection examples/demo
O valor do segredo nunca é gravado no projeto, no relatório, no log ou na exportação padrão. Ele aparece apenas como ••••••/<segredo>.
Todos os comandos aceitam --collection <diretório> e --json quando fazem sentido.
| Comando | Uso |
|---|---|
init |
cria uma coleção local. |
run |
executa a coleção ou filtros (--env, --tag, --request, --folder). |
send |
envia uma requisição salva. |
import |
importa cURL, Postman ou OpenCollection. |
export |
exporta cURL, Postman, OpenCollection ou o projeto. |
validate |
valida arquivos e compatibilidade. |
requests |
lista requisições na ordem de execução. |
env list/show |
inspeciona ambientes sem revelar segredos. |
history |
lê o histórico local de execuções. |
migration inspect |
prepara um plano de migração sem alterar arquivos. |
migration apply |
aplica um plano confirmado, com backup e hashes. |
migration rollback |
reverte uma migração sem edições posteriores. |
migration list |
lista planos, aplicações e rollbacks. |
Exemplos:
# Lista e executa por tag
cargo run -- --collection examples/demo requests
cargo run -- --collection examples/demo run --tag smoke --json
# Envia uma requisição específica
cargo run -- --collection examples/demo send req_4a2b3c4d5e6f7081 --env dev
# Importa um comando cURL ou uma coleção Postman
cargo run -- --collection minha-api import curl "curl -X POST http://127.0.0.1:18080/echo -d '{\"ok\":true}'"
cargo run -- --collection minha-api import postman ./collection.json
# Exporta um comando cURL, sem credenciais literais (templates são preservados)
cargo run -- --collection examples/demo export curl req_4a2b3c4d5e6f7081 --output /tmp/echo.sh
# Exporta o projeto sanitizado (o destino não pode existir; comentários podem ser normalizados)
cargo run -- --collection examples/demo export project --output /tmp/demo-copia
# Inspeciona, aplica e reverte uma migração de schema
cargo run -- --collection minha-api migration inspect
cargo run -- --collection minha-api migration apply <plan-id> --revision <revisao>
cargo run -- --collection minha-api migration rollback <plan-id> --revision <revisao>Código de saída de run: 0 quando não há falhas/erros/cancelamentos; 1 caso contrário. validate também retorna 1 quando encontra problemas ou arquivos não suportados.
- Árvore navegável por teclado (
↑/↓,Home/End,←/→em pastas). - Editor de parâmetros, headers, corpo, auth, scripts e asserções.
- Autosave de rascunho com estados visíveis e recuperação na reabertura.
- Aviso de alteração externa, comparação e recarga sem sobrescrever edição.
- Lixeira com restauração e escolha de destino.
- Diálogo de migração com inspeção, confirmação, backup e rollback.
- Painel de resposta com prévia incremental, corpo bruto, headers, testes e logs.
- Runner com filtros, ambiente, relatório e cancelamento.
- Editor de ambientes, segredos por referência e configurações da coleção.
- Importação/exportação e validação pela própria UI.
Atalhos principais:
| Atalho | Ação |
|---|---|
Ctrl/Cmd+S |
salvar requisição |
Ctrl/Cmd+Enter |
enviar requisição |
Ctrl/Cmd+K |
filtrar a árvore |
Alt+N |
nova requisição |
Alt+F |
nova pasta |
Alt+R |
abrir runner |
? |
ajuda e atalhos |
| Caminho | Responsabilidade |
|---|---|
src/model.rs |
modelo canônico OpenCollection + extensões Reqlivo. |
src/store.rs |
persistência, árvore, revisões, ambientes e delegação da lixeira. |
src/persist.rs |
hashes, escrita atômica, permissões, caminhos seguros e lock entre processos. |
src/drafts.rs |
rascunhos versionados, gerações, órfãos e adoção. |
src/trash.rs |
índice da lixeira, restauração, reconciliação e entradas legadas. |
src/migration.rs |
planos, inspeção somente-leitura, aplicação, rollback e recuperação. |
src/variables.rs |
resolução de variáveis, precedência e segredos. |
src/auth.rs |
auth efetiva e herança. |
src/body.rs |
URL, params, headers, auth e corpos preparados. |
src/transport.rs |
HTTP, metadados, limites, redirects e offline. |
src/scripts.rs |
sandbox QuickJS, rq.*, test/expect, timeout e logs. |
src/assertions.rs |
operadores declarativos. |
src/runner.rs |
execução, status, relatório, hash e redaction. |
src/import_export.rs |
cURL, Postman, OpenCollection e projeto. |
src/server.rs |
operações do núcleo com roteamento em memória, sem listener. |
src/desktop.rs |
adaptador IPC testável sem WebView. |
src-tauri/ |
janela, diálogos, estado e instaladores Tauri 2. |
src/main.rs |
CLI clap, relatórios e códigos de saída. |
src/assets/ |
HTML, CSS e JavaScript da interface. |
tests/integration.rs |
testes ponta a ponta com servidor HTTP sintético. |
Inspirado no Insomnia e no Bruno, o Reqlivo é um projeto independente, sem afiliação com esses produtos.
Consulte também o guia de contribuição.
- A interface só acessa o núcleo via IPC Tauri. Nenhuma porta é aberta para a UI; APIs de destino são chamadas pelo Rust.
- Credenciais devem ser variáveis ou segredos referenciados; a UI avisa sobre valores literais.
- Rascunhos são texto local sem criptografia e podem conter credenciais literais digitadas; no Unix, os arquivos usam permissão
0600. Segredos resolvidos deprovider: envnão são gravados. - Logs, mensagens de teste, URLs e headers conhecidos como sensíveis são redigidos.
- Exportações padrão omitem auth/cabeçalhos/parâmetros literais sensíveis e variáveis marcadas como segredo.
- Segredos usam
provider: env;systemefileainda não são implementados. REQLIVO_OFFLINE=1ou a configuração da coleção ativam o modo offline, inclusive para redirecionamentos.
MIT — permite usar, modificar e distribuir o projeto, inclusive comercialmente, mantendo o aviso de copyright e a licença.