Começar

Neste guia você vai instalar o MB CLI e entender o básico do seu funcionamento.

Pré-requisitos

• Linux ou macOS (amd64 ou arm64)
• Bash disponível no sistema
• curl instalado (para o script de instalação)

Instalação rápida

A forma mais simples é usar o script de instalação, que baixa o binário do MB CLI e suas dependências (gum, glow, jq, fzf, yq) direto do GitHub Releases:

curl -sSL https://raw.githubusercontent.com/carlosdorneles-mb/mb-cli/main/install.sh | bash

Para detalhes sobre dependências, variáveis de ambiente e verificação automática de versão, veja Instalação Detalhada.

Instalação com versão específica

Para fixar uma versão:

curl -sSL https://raw.githubusercontent.com/carlosdorneles-mb/mb-cli/main/install.sh | bash -s -- --version 0.0.5

Verificar instalação

mb --version
mb help

Se o comando mb não for encontrado, garanta que ~/.local/bin está no seu PATH:

# Adicione ao ~/.bashrc, ~/.zshrc ou equivalente
export PATH="$HOME/.local/bin:$PATH"

Diretórios por sistema operacional

O MB CLI usa diretórios padrão para configuração, cache e helpers. Para detalhes completos, veja Cache SQLite.

Resumo rápido:

Sistema	Configuração	Cache
Linux	~/.config/mb	~/.config/mb/cache.db
macOS	~/Library/Application Support/mb	~/Library/Application Support/mb/cache.db

A variável de ambiente MB_HELPERS_PATH (injetada nos plugins) aponta automaticamente para o diretório correto do seu sistema.

Primeiro uso

Após a instalação, sincronize os plugins (mesmo que ainda não tenha nenhum):

mb plugins sync

Isso atualiza o cache de comandos e os helpers de shell.

Adicionar um plugin

Para adicionar um plugin, use mb plugins add com uma URL Git ou path local:

# Por URL Git
mb plugins add https://github.com/org/repo

# Por path local (sem copiar arquivos)
mb plugins add /caminho/para/meu-plugin --package meu-plugin

Após adicionar, o sync é automático. Para detalhes completos sobre gestão de plugins, veja Comandos de plugins e Criar um plugin.

Atualizar

O comando mb update cuida de tudo:

# Atualizar tudo (plugins, CLI, ferramentas, sistema)
mb update

# Só o binário do MB CLI
mb update --only-cli

# Só os plugins
mb update --only-plugins

# Só verificar se há nova versão do CLI
mb update --only-cli --check-only

Desinstalar

curl -sSL https://raw.githubusercontent.com/carlosdorneles-mb/mb-cli/main/uninstall.sh | bash

Ou remova manualmente:

# Binário
rm -f ~/.local/bin/mb

# Dependências (se instaladas pelo install.sh)
rm -f ~/.local/bin/gum ~/.local/bin/glow ~/.local/bin/jq ~/.local/bin/fzf

Para limpar dados e configuração:

# Linux
rm -rf ~/.config/mb

# macOS
rm -rf ~/Library/Application\ Support/mb

Nota: A desinstalação pelo script ou remoção manual dos binários não apaga os dados de configuração e plugins. Remova os diretórios acima se desejar uma limpeza completa.

Resumo rápido

Ação	Comando
Instalar	curl -sSL …/install.sh | bash
Sincronizar	mb plugins sync
Listar plugins	mb plugins list
Adicionar plugin	mb plugins add <url ou path>
Atualizar tudo	mb update
Ajuda	mb help
Desinstalar	curl -sSL …/uninstall.sh | bash

Próximos passos

• Instalação Detalhada — Dependências, variáveis de ambiente e configuração
• Desenvolvimento Local — compilar a partir do código
• Criar um plugin — montar seu primeiro plugin
• Variáveis de ambiente — ordem de precedência e uso
• Comandos de plugins — descobrir e executar comandos