sqlew Plugin
sqlew-io/sqlew-plugin
Contexto compartilhado e ADRs automáticas para planejamento colaborativo
Ver no GitHubServidor MCP para compartilhamento de contexto com integração Plan-to-ADR. Automatiza configuração de skills e hooks para Claude Code, Grok Build e Codex, eliminando setup manual de MCP servers e decisões arquiteturais.
Instalação
npx convez-ai sqlew-io/sqlew-plugin1 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
Casos de uso
- Documentar decisões arquiteturais automaticamente em PRs
- Rastrear planos e restrições em modo Plan Mode
- Sincronizar contexto entre Claude Code, Grok e Codex sem configuração manual
Veredito

Ferramenta especializada para times que usam Plan Mode e precisam documentação automática de decisões. Reduz fricção de setup, mas público é específico (usuários de sqlew + múltiplos ambientes Claude).
README
A tradução para o português deste README ainda está na fila.
sqlew-plugin
Plugin for sqlew — context sharing MCP server with Plan-to-ADR integration. Supports Claude Code, Grok Build (v5.2+), and Codex (v5.2.1+).
Features
- Skills: Auto-triggered guidance for Plan Mode decision/constraint formatting
- Hooks: Automatic context suggestion and decision saving
Installation
Prerequisites
Install the sqlew MCP server globally:
npm i -g sqlew
Claude Code
# Add the marketplace
claude plugin marketplace add sqlew-io/sqlew-plugin
# Install the plugin
claude plugin install sqlew
Grok Build
grok plugin install sqlew-io/sqlew-plugin --trust
grok plugin update
The plugin automatically configures:
- MCP server settings (
.mcp.json) - Skills (plan mode guidance, decision format, PR ADR)
- Hooks (plan tracking, decision extraction)
Note: No manual
.mcp.jsonor~/.grok/config.tomlMCP entry required. Do not duplicate hooks in~/.grok/hooks/.
Codex
npm i -g sqlew
codex plugin marketplace add sqlew-io/sqlew-plugin
codex plugin install sqlew --source sqlew-plugin
After install, open /hooks in Codex and trust the bundled sqlew hooks.
Enable Plan mode in Codex when needed:
[features]
collaboration_modes = true
The plugin automatically configures:
- MCP server settings (
.mcp.json) - Skills (plan mode guidance, decision format, PR ADR)
- Hooks (plan enforcement, PR ADR guard, decision extraction)
Note: Do not manually copy skills into
~/.codex/skills/or add[mcp_servers.sqlew]toconfig.tomlwhen using the plugin (duplicate registration).
Why Use the Plugin?
- Automatic Setup: Skills, Hooks, and MCP config are installed automatically
- Clean Uninstall:
claude plugin remove sqlewremoves everything cleanly - No Project Clutter: No files left in your project directories
Local Development
git clone https://github.com/sqlew-io/sqlew-plugin.git
cd sqlew-plugin
# Claude Code
claude plugin marketplace add .
claude plugin install sqlew
# Grok Build
grok plugin install . --trust
# Codex
codex plugin marketplace add .
codex plugin install sqlew
Components
Skills
| Skill | Description |
|---|---|
sqlew-decision-format | Guides Plan Mode decision/constraint formatting with Markdown patterns |
sqlew-plan-guidance | Quick reference for sqlew Plan-to-ADR integration |
sqlew-pr-adr | Enriches PR bodies with ADR context via diff-based decision reverse lookup |
Hooks
| Event | Action | Description |
|---|---|---|
| PreToolUse (Task) | sqlew suggest | Suggests related decisions before task execution |
| PreToolUse (Write|EnterPlanMode|apply_patch) | sqlew track-plan | Tracks plan file changes (Grok: injects template into plan.md) |
| PreToolUse (Bash|shell_command|shell) | sqlew pr-adr | Blocks gh pr create without ADR markers |
| PostToolUse (ExitPlanMode|exit_plan_mode) | sqlew on-exit-plan | Extracts decisions from plan on exit |
| PostToolUse (Edit|Write|apply_patch) | sqlew save | Auto-saves decisions from edited files |
| PostToolUse (TodoWrite) | sqlew check-completion | Checks task completion status |
| UserPromptSubmit | sqlew on-prompt | Injects plan mode enforcement (Claude + Codex) |
| SessionStart | sqlew on-session-start | Session startup hooks |
| SubagentStop | sqlew on-subagent-stop | Processes subagent results |
| Stop | sqlew on-stop / sqlew on-exit-plan | Cleanup; Codex plan extraction on stop |
Uninstallation
claude plugin remove sqlew
Related
- sqlew MCP Server - The MCP server that provides decision/constraint management
- Claude Code Plugins - Official plugin documentation
License
Apache-2.0