convez.ai
MCP ServerIntegração & APIsIntermediário
sqlew-io

sqlew Plugin

sqlew-io/sqlew-plugin

Contexto compartilhado e ADRs automáticas para planejamento colaborativo

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-plugin

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
2
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 1 semana
Versão
v5.4.1
Issues abertas
0
Contribuidores
1

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.json or ~/.grok/config.toml MCP 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] to config.toml when using the plugin (duplicate registration).

Why Use the Plugin?

  • Automatic Setup: Skills, Hooks, and MCP config are installed automatically
  • Clean Uninstall: claude plugin remove sqlew removes 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

SkillDescription
sqlew-decision-formatGuides Plan Mode decision/constraint formatting with Markdown patterns
sqlew-plan-guidanceQuick reference for sqlew Plan-to-ADR integration
sqlew-pr-adrEnriches PR bodies with ADR context via diff-based decision reverse lookup

Hooks

EventActionDescription
PreToolUse (Task)sqlew suggestSuggests related decisions before task execution
PreToolUse (Write|EnterPlanMode|apply_patch)sqlew track-planTracks plan file changes (Grok: injects template into plan.md)
PreToolUse (Bash|shell_command|shell)sqlew pr-adrBlocks gh pr create without ADR markers
PostToolUse (ExitPlanMode|exit_plan_mode)sqlew on-exit-planExtracts decisions from plan on exit
PostToolUse (Edit|Write|apply_patch)sqlew saveAuto-saves decisions from edited files
PostToolUse (TodoWrite)sqlew check-completionChecks task completion status
UserPromptSubmitsqlew on-promptInjects plan mode enforcement (Claude + Codex)
SessionStartsqlew on-session-startSession startup hooks
SubagentStopsqlew on-subagent-stopProcesses subagent results
Stopsqlew on-stop / sqlew on-exit-planCleanup; Codex plan extraction on stop

Uninstallation

claude plugin remove sqlew

Related

License

Apache-2.0

Ver o original no GitHub

Bom para

Relacionados