convez.ai
MCP ServerDesenvolvimento WebIntermediário
httuicom

httui

httuicom/httui

Editor markdown executável: docs, APIs e SQL em um arquivo

Ver no GitHub
BomPluginScore · de 0 a 100

Editor markdown desktop com runtime integrado para documentar, testar e executar requisições HTTP e queries SQL — tudo em arquivos `.md` versionáveis. Combina Postman, DBeaver e documentação em uma única ferramenta git-native, com suporte a referências entre blocos, ambientes, caching e agente IA.

Instalação

$npx convez-ai httuicom/httui

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
17
Forks
1
Acompanhando
1
Saúde
87%
Último commit
há 2 meses
Versão
v0.4.5
Issues abertas
77
Contribuidores
2

Casos de uso

  • Documentar e testar APIs localmente sem deixar o editor
  • Executar queries SQL e requisições HTTP em sequência com referências automáticas
  • Versionear fluxos de integração em git como markdown puro

Veredito

Ferramenta criativa que reimagina o workflow de documentação e testes de API — híbrido entre editor de texto, Postman e DBeaver. Excelente para equipes que valorizam versionamento em git e workflows reproducíveis, com MCP integration adicional para assistência IA.

README

A tradução para o português deste README ainda está na fila.

httui

Your API docs, alive.

A desktop markdown editor with a runtime inside. Write the doc, hit run, ship the proof.

Website · Releases · Contributing · Security

What is httui?

httui collapses four tools into one markdown file:

BeforeWith httui
Document APIs in NotionDocs that execute
Test requests in PostmanRequests next to the docs
Query the DB in DBeaverSQL in the same file
Chain calls in a shell scriptBlocks reference blocks

Everything serializes to standard .md files. Read them in vim, diff them in git, open them in Obsidian.

See it in action: httui.com

Features

Executable blocks — HTTP requests and SQL queries live inline in your markdown as fenced code blocks.

Block references — {{create-user.response.id}} lets blocks reference each other. Dependencies execute automatically in the right order. DAG by construction, no cycles possible.

Database support — Postgres, MySQL, SQLite with schema-aware autocomplete. SQL references become bind parameters, never string-interpolated.

Environments — Key-value variables resolved with {{KEY}} syntax. Secret values encrypted via OS keychain.

AI assistant — Claude agent with MCP tools that reads, searches, and modifies your notes. Every write stops at a permission prompt with side-by-side diff.

Multi-pane editor — Binary tree layout with tabs, drag-drop reordering, split views.

Vim mode — CodeMirror 6 with @replit/codemirror-vim for full motion support inside fenced blocks.

Full-text search — FTS5 index in SQLite. Quick-open (Cmd+P) and content search (Cmd+Shift+F).

Result caching — Results cached by content hash. Rerun only what changed.

Installation

Pick whichever you prefer — both end up at the same build.

Install script (macOS & Linux) — one line, no Homebrew:

curl -fsSL https://httui.com/install.sh | sh

Homebrew (macOS & Linux):

brew tap httuicom/httui
brew install --cask httui

Manual — download a .dmg (macOS), .msi/.exe (Windows), or .deb/.rpm/.AppImage (Linux) from Releases.

Terminal mode

Every install also ships the TUI and a unified httui command:

httui                   # opens the terminal UI
httui desktop           # opens the desktop app
httui --help

Double-clicking the app icon still opens the desktop directly. macOS (Homebrew) and Linux (.deb/.rpm) put httui on the PATH automatically; on Windows add %LOCALAPPDATA%\Programs\httui to your PATH or run httui.exe from that folder.

The macOS build is an unsigned developer build. The install script and the Homebrew cask both clear the Gatekeeper quarantine for you. A manually downloaded .dmg needs a one-time xattr -dr com.apple.quarantine /Applications/httui.app (or right-click → Open). In-app auto-update keeps it current after the first install.

5-minute tour

  1. Download the latest release from Releases and open a folder of markdown files.
  2. In any .md file, type /http to insert a request block:
    GET https://api.github.com/users/octocat
    Accept: application/vnd.github+json
    
  3. Press ▶ (or Cmd+Enter) — the response appears inline, with body / headers / cookies / timing tabs.
  4. Reference the result in another block:
    GET {{octocat.response.html_url}}
    
    The dependency runs first; the second request uses the resolved URL.
  5. Open a SQL block over a connection (db-postgres, db-mysql, db-sqlite), run queries, reference rows the same way.

That's the loop: write, run, reference, commit. The whole notebook is plain .md, so it lives next to the code in your repo.

Tech stack

LayerTechnology
RuntimeTauri v2 (Rust)
FrontendReact + TypeScript + Vite
EditorCodeMirror 6
UIChakra UI v3 + Emotion
StorageSQLite (SQLx) + filesystem (.md)
SearchFTS5
AIClaude Agent SDK via Node.js sidecar
SecretsOS keychain (keyring crate)

Building from source

# Prerequisites: Rust stable (1.80+), Node.js 20+, bun (for the sidecar)

# Install deps once
make install-deps

# Development (Vite HMR + Tauri rebuild on Rust change)
make dev

# Production build
make build

# Tests
npm test               # Frontend (vitest, runs against httui-desktop)
cargo test --workspace # Backend (all Rust crates)

The repo is a Cargo + npm workspace. Top-level layout: httui-core/, httui-desktop/, httui-tui/, httui-mcp/, httui-sidecar/. See CONTRIBUTING.md for the full breakdown. The marketing landing and end-user docs live in httui-site and are deployed to httui.com.

Security

  • Passwords and secret environment variables are encrypted via the OS keychain. SQLite only stores a sentinel value.
  • SQL block references are always converted to bind parameters — zero string interpolation.
  • Chat AI writes require explicit user permission with diff review.

Found a security issue? Please follow SECURITY.md.

Contributing

Contributions are welcome. Start with CONTRIBUTING.md for local setup, commit conventions, and PR expectations. Please also read the Code of Conduct.

License

MIT © João Ferreira and httui contributors.

Ver o original no GitHub

Bom para

Relacionados