b2-cli

CLI interativa para instalar skills e templates do Cursor em qualquer projeto. O comando usa o diretório atual (cwd) como alvo — rode de dentro do projeto em que você está trabalhando.

Requisitos

• Node.js 18 ou superior
• npm, Yarn ou pnpm

Uso

Não é necessário instalar a CLI globalmente. Execute-a dentro do projeto em que deseja criar skills e templates: o diretório atual (cwd) é o alvo da gravação.

npm:

cd ~/projetos/meu-app
npx b2-cursor-cli

Yarn:

cd ~/projetos/meu-app
yarn dlx b2-cursor-cli

pnpm:

cd ~/projetos/meu-app
pnpm dlx b2-cursor-cli

Para forçar a versão mais recente publicada:

npx b2-cursor-cli@latest

O menu interativo abre na sequência. Você também pode passar o contexto direto:

npx b2-cursor-cli git
npx b2-cursor-cli review
npx b2-cursor-cli whats-new

(Com Yarn ou pnpm, troque npx por yarn dlx ou pnpm dlx.)

1. Selecione quais arquivos deseja criar (ou Criar todos).
2. Os arquivos são gravados no projeto atual — por exemplo em .cursor/skills/, .cursor/mcp.json ou .specify/.

Importante: rode o comando na raiz (ou pasta) do repositório onde a CLI deve atuar. Nada é instalado na sua máquina de forma permanente; os artefatos vão só para esse diretório.

Ao iniciar, a CLI avisa se houver uma versão mais nova no npm e pode exibir um banner com as novidades. Para rever o histórico por versão: npx b2-cursor-cli whats-new.

Comandos

| Comando | Descrição | | ----------------------------- | ------------------------------- | | npx b2-cursor-cli | Abre o menu interativo | | npx b2-cursor-cli clickup | Contexto ClickUp | | npx b2-cursor-cli git | Contexto Git | | npx b2-cursor-cli github | Contexto GitHub | | npx b2-cursor-cli review | Contexto Review | | npx b2-cursor-cli split | Contexto Split | | npx b2-cursor-cli task | Contexto Task | | npx b2-cursor-cli whats-new | Novidades de cada versão da CLI | | npx b2-cursor-cli --help | Lista os comandos disponíveis |

Contextos disponíveis

ClickUp

Integração com ClickUp via MCP e plugin do Cursor.

| Arquivo | Destino | | ------------------- | ---------------------------------------------------------------- | | MCP Server | .cursor/mcp.json | | Plugin settings | .cursor/settings.json | | Send to review | .cursor/skills/clickup/b2-clickup-send-to-review/SKILL.md | | Create backlog task | .cursor/skills/clickup/b2-clickup-create-backlog-task/SKILL.md | | Project config | .project-config/settings.json |

Git

Skills de versionamento e fluxo de trabalho com Git.

| Arquivo | Destino | | -------- | --------------------------------------------- | | Commit | .cursor/skills/git/b2-git-commit/SKILL.md | | Worktree | .cursor/skills/git/b2-git-worktree/SKILL.md |

GitHub

Skills para fluxo de trabalho com GitHub e gh CLI.

| Arquivo | Destino | | ------------------ | ------------------------------------------------------------- | | Agente GitHub CLI | .cursor/agents/b2-github-cli.md | | Pull Request | .cursor/skills/github/b2-github-pull-request/SKILL.md | | Get Change Request | .cursor/skills/github/b2-github-get-change-request/SKILL.md |

Review

Skills de automated review: configuração, padrões de código e revisão do diff.

| Arquivo | Destino | | ------------------ | ----------------------------------------------- | | Init review config | .cursor/skills/b2-init-review-config/SKILL.md | | Review template | .specify/templates/review/template.md | | Get code pattern | .cursor/skills/b2-get-code-pattern/SKILL.md | | Code review | .cursor/skills/b2-code-review/SKILL.md |

Split

Divide a branch atual em slices reviewáveis e abre PRs no GitHub.

| Arquivo | Destino | | ----------------- | -------------------------------------------------------------- | | Split em branches | .cursor/skills/split/b2-split-feature-into-branches/SKILL.md |

Task

Planejamento, execução de tasks e skills para IA.

| Arquivo | Destino | | ------------- | --------------------------------------------- | | Plan ref | .specify/plan-ref.json | | Plan template | .specify/templates/task/template.md | | Create plan | .cursor/skills/task/b2-task-create/SKILL.md | | Execute plan | .cursor/skills/task/b2-task-exec/SKILL.md |

Desenvolvimento

Clone o repositório e instale as dependências:

git clone [email protected]:b2bitcompany/b2-cli.git
cd b2-cli
pnpm install
pnpm setup

Scripts úteis:

pnpm start              # roda a CLI em modo dev (tsx)
pnpm start -- git       # roda direto no contexto git
pnpm build              # compila para dist/
pnpm typecheck          # verifica tipos
pnpm lint               # ESLint

Para testar o binário localmente (após o build):

node dist/main.js --help

Contribuindo

Quer reportar um bug, sugerir uma feature ou abrir um PR? Veja o guia em CONTRIBUTING.md.

Há templates prontos no GitHub:

• Issues: .github/ISSUE_TEMPLATE/
• Pull requests: .github/PULL_REQUEST_TEMPLATE/

Licença

ISC — Delmar Filho