Adiciona o GBit Shell à lista de terminais integrados do VS Code.
p align="center">
O que éGBit Shell é uma segunda opção de terminal para quem já usa Git Bash, PowerShell ou Zsh. Ele roda sobre o shell do sistema, então seus comandos habituais continuam funcionando exatamente como antes — só que agora com prompt informativo, autocompletar de verdade, e comandos como É um shell interativo escrito em Python, que roda igual no Windows, macOS e Linux, e também se instala como perfil de terminal integrado no VS Code, junto com PowerShell, cmd e Git Bash. O prompt fica assim:
Cada trecho tem um propósito: usuário e máquina, o selo do projeto, o caminho encurtado, o estado do git (arquivos no stage, modificados, novos), o ambiente virtual do Python ativo, e a detecção de projeto Node. InstalaçãoVia npx — não instala nada permanentemente
Via npm — instalação global
Via pip — direto do PyPI
Na primeira execução via
Abrir o terminalDepois de instalado, por qualquer um dos três caminhos:
Usar dentro do VS CodeAdiciona o GBit Shell à lista de terminais integrados do VS Code, junto com PowerShell, cmd e Git Bash. Instalar a extensão (recomendado)Depois de instalar o GBit Shell via npm ou pip, dentro do terminal GBit Shell, rode:
Isso gera o
Se quiser só gerar o
O arquivo é salvo em
Depois de instalar, recarregue a janela (
Pra torná-lo o terminal padrão: Configuração manual (sem a extensão)Se preferir não instalar a extensão, adicione isto ao
Comandos da extensão
Nas configurações ( ComandosGitHubRequisitosPython 3.9 ou superior. Nada mais é obrigatório — o
O comando que dá nome ao projeto
Na primeira vez:
Um comando faz tudo o que normalmente são vários passos decorados: cria o repositório git se não existir, gera um
Desenvolvimento
O Navegação e arquivos
Esses comandos são implementados em Python, então funcionam igual no Windows, sem precisar de coreutils ou Git Bash. Shell
Qualquer comando que não seja builtin é repassado ao sistema. Controle de jobs
Sem argumento, Ver exemplo completo de controle de jobsEm sistemas POSIX (Linux, macOS, WSL) o GBit Shell tem controle de jobs completo, do mesmo jeito que o bash:
Ao tentar sair com jobs ativos, o shell avisa e pede confirmação — um segundo No Windows, Configuração por projeto:
|
| Chave | Para que serve |
|---|---|
name |
nome exibido nas informações do projeto |
tag |
selo do prompt enquanto você está no projeto |
theme |
tema aplicado dentro do projeto |
env |
variáveis carregadas no ambiente |
aliases |
atalhos que existem só neste projeto |
scripts |
tarefas chamadas com run <nome> |
onEnter |
comando rodado ao entrar no projeto |
| Comando | Descrição |
|---|---|
project |
mostra o projeto detectado, o arquivo, os scripts e os aliases |
project init |
cria um gbit.json inicial, adivinhando o tipo do projeto |
project reload |
recarrega o arquivo depois de editar |
run |
lista os scripts disponíveis |
run <nome> |
executa o script; argumentos extras são repassados |
O project init olha o diretório antes de escrever: em um projeto Node ele já preenche os scripts a partir do package.json; em Python, sugere pytest; se encontrar um Dockerfile ou docker-compose.yml, inclui os atalhos de container. A tag do prompt sempre nasce como GBIT — personalize depois se quiser um selo próprio por projeto.
Aliases do projeto têm prioridade sobre os do ~/.gbitrc, e o Tab completa os nomes de run. As variáveis de env valem apenas na sessão, nunca escrevem nada no sistema.
Atalhos de teclado
| Atalho | Ação |
|---|---|
Tab |
completa comando, caminho, subcomando do git, branch, script do npm |
↑ ↓ |
navega no histórico |
→ |
aceita a sugestão em cinza |
Ctrl+R |
busca reversa no histórico |
Ctrl+A / Ctrl+E |
início / fim da linha |
Ctrl+W |
apaga a palavra anterior |
Ctrl+U |
apaga a linha |
Ctrl+L |
limpa a tela |
Ctrl+C |
cancela o comando, sem fechar o shell |
Ctrl+Z |
para o comando atual e devolve o prompt (POSIX) |
Ctrl+D |
sai |
O autocompletar é sensível ao contexto: git ch + Tab sugere checkout; git checkout + Tab lista as branches reais do repositório; num projeto Node, npm run + Tab lista os scripts do package.json.
Configuração
O arquivo ~/.gbitrc é criado na primeira execução.
# Prompt
set theme=ocean
set tag=WEB3
set show_git=true
set show_venv=true
set show_time=false
set prompt_style=full # full ou minimal
# Atalhos
alias ll=ls -la
alias gs=git status
alias dev=npm run dev
alias pub=ghpush
# Ambiente
export EDITOR=code
# Executado ao abrir o shell
run sysinfo
Depois de editar manualmente, rode reload pra aplicar sem reiniciar.
Temas
| Tema | Aparência |
|---|---|
gbit |
ciano e violeta — o padrão |
ocean |
tons de azul |
mono |
sem cores, pra terminais limitados |
Ajustando o prompt na hora
O selo node vem desligado de fábrica, pro prompt ficar limpo. O comando set mostra e muda as opções sem reiniciar:
set # lista tudo com os valores atuais
set show_node=true # mostra o selo "node" em projetos com package.json
set show_git=false # esconde o estado do git
set prompt_style=minimal # prompt curto, só o caminho
set tag=WEB3 --save # muda o selo e grava no ~/.gbitrc
Sem --save a mudança vale só pra sessão atual — ótimo pra experimentar. Com --save, a linha é escrita (ou substituída) no ~/.gbitrc.
Selo preso num valor antigo? Se o prompt mostrar um selo que você não configurou, é porque ele foi gravado no
~/.gbitrcem algum momento com--save. Edite o arquivo, ajuste a linhaset tag=...(ou apague-a pra voltar ao padrãoGBIT), e rodereload.
Uso não interativo
gbit -c "ghpush -m 'deploy'" # roda um comando e sai
gbit --no-banner # abre sem o logo
gbit --version
Útil em scripts e em pipelines de CI.
Estrutura do projeto
gbit-shell/
├── bin/
│ ├── gbit launcher POSIX
│ ├── gbit.cmd launcher Windows CMD
│ └── gbit.js launcher Node, usado pelo npm/npx
├── gbit_shell/
│ ├── __main__.py ponto de entrada, parsing de argumentos
│ ├── shell.py sessão interativa, loop principal
│ ├── executor.py execução: builtins, pipes, jobs, passthrough
│ ├── builtins.py os comandos internos
│ ├── jobs.py gerenciador de jobs, sinais e terminal
│ ├── jobcmds.py jobs, fg, bg, kill, wait, disown
│ ├── project.py leitura do gbit.json e detecção de projeto
│ ├── completer.py autocompletar sensível ao contexto
│ ├── prompt.py montagem do prompt
│ ├── styles.py temas de cor
│ ├── gitinfo.py leitura rápida do estado do git, com cache
│ └── config.py leitura do ~/.gbitrc
├── vscode-extension/
│ ├── extension.js integração com o VS Code
│ └── package.json manifesto da extensão
├── tools/
│ └── build_vsix.py empacota a extensão sem depender do Node
├── assets/
│ ├── banner-gbit-shell.png banner do topo do README
│ └── banner-terminal.png banner da publicacao no GitHub
├── tests/
│ ├── test_shell.py núcleo do shell
│ └── test_jobs_project.py jobs e configuração de projeto
├── gbit.json configuração do próprio projeto
├── pyproject.toml
├── package.json
└── README.md
Como funciona por dentro
O shell lê uma linha, expande aliases (do projeto primeiro, depois os globais), e divide a linha em &&, || e ; no próprio Python. Cada parte segue um de três caminhos:
- Se tem pipe, redirecionamento ou glob, delega ao shell do sistema, que já sabe fazer isso bem.
- Se o primeiro token é um builtin, executa a função Python correspondente.
- Caso contrário, cria o processo diretamente com
subprocess, sem camada de shell.
Essa divisão é o que mantém o shell rápido e ao mesmo tempo compatível — é o que faz cd api && npm install funcionar de verdade, mudando o diretório do próprio shell.
O controle de jobs segue o modelo POSIX: cada comando nasce em um grupo de processos próprio (setpgrp), o shell entrega o terminal a esse grupo com tcsetpgrp e o retoma depois. Os filhos recebem os sinais de parada restaurados ao comportamento padrão, então Ctrl+Z chega em quem deve. Jobs terminados são recolhidos sem bloquear, e o aviso aparece antes do próximo prompt.
O estado do git no prompt vem de chamadas com timeout curto e cache de 1,5 segundo por diretório, então o prompt não trava mesmo em repositórios grandes.
Testes
pip install pytest
python -m pytest tests/ -v
Cobrem parsing de configuração, expansão de aliases, encurtamento de caminho, detecção de metacaracteres, divisão de sequências com &&, ciclo de vida de jobs, leitura e escrita do gbit.json, detecção de tipo de projeto, temas, autocompletar, leitura do git, e o CLI de ponta a ponta.
Segurança
O comando env oculta valores de variáveis cujo nome contém TOKEN, SECRET, PASSWORD, KEY ou PASS. O módulo de GitHub nunca imprime nem armazena credenciais — a autenticação fica inteiramente a cargo do gh CLI e do git.
O comando serve sobe um servidor HTTP sem autenticação e avisa isso ao iniciar. Use apenas em rede local.
Licença
MIT
Autor
Gislaine Lopes · gbit-ecossistema, open source E-mail: gislainelophes@gmail.com
