braia-os — Hub Central

182

Brew Packages

25+

CLI Tools

3

SOs Suportados

11

Configs Versionadas

Distribuicao de Ferramentas por Camada

Stack completa 130 formulae + 39 casks + 11 taps

Core (45%)

macOS (30%)

Linux (15%)

Win (10%)

CLI vs GUI

75% CLI — workflow keyboard-driven prioriza ferramentas de terminal

Cross-platform

65% das ferramentas funcionam nos 3 SOs sem alteracao

Config versionada

90% das configs mapeadas no repo com symlinks automaticos

Arquitetura em Camadas

SHARED

Camada Core

macOS + Linux + Windows

macOS

Desktop macOS

AeroSpace + SketchyBar + Kanata

Linux

Desktop Linux (Arch)

Hyprland + Waybar + Kanata

Windows

Desktop Windows

GlazeWM + Kanata + PowerToys

Mapa de Equivalencias

Mesmos keybindings (alt+hjkl), mesma experiencia, ferramentas diferentes por SO.

Funcao	macOS	Linux	Windows
Tiling WM	AeroSpace	Hyprland	GlazeWM
Status Bar	SketchyBar (Lua)	Waybar	GlazeWM bar
Hotkeys	skhd	Hyprland binds	GlazeWM binds
Key Remap	Kanata + Karabiner	Kanata	Kanata
Launcher	Raycast	Wofi	PowerToys Run
Shell	Fish + Starship + Atuin + Zoxide + fzf (identico)
Terminal	Kitty	Kitty	Alacritty / Windows Terminal
Editor	Zed + Neovim	Zed + Neovim	Neovim
Multiplexer	tmux (identico — prefix Ctrl+A, vim-like nav)

Mapa de Keybindings Unificado

Window Management

alt + h j k lFocus left/down/up/right

alt + shift + h j k lMove window

alt + 1-9Switch workspace

alt + fFullscreen

alt + shift + fFloat toggle

Kanata Layers

caps (tap)Toggle INSERT/NORMAL

caps (hold)Left Shift

space (hold) + h/lHome / End

space (hold) + a/c/x/zCmd+A/C/X/Z

; (tap/hold)Space / Enter

App Launchers (skhd)

cmd + returnOpen Kitty

alt + cmd + kReload SketchyBar

alt + shift + rReload AeroSpace + bars

Tmux (prefix Ctrl+A)

cmd + alt + returnNew window

| / -Split V / H

h j k lNavigate panes

Paginas do Projeto

Quick Start — Bootstrap

Boota pelo Ventoy USB, escolhe o SO, instala, e depois executa:

macOS

git clone <repo> ~/braia-os
cd ~/braia-os
./bootstrap.sh

Arch Linux

git clone <repo> ~/braia-os
cd ~/braia-os
./bootstrap.sh

Windows

git clone <repo> ~\braia-os
cd ~\braia-os
.\bootstrap.ps1

O bootstrap detecta o SO automaticamente e instala: package manager, CLI tools, version managers (fnm, pyenv, sdkman, rustup), shell (Fish + Starship + Atuin + Zoxide), fonts (Nerd Fonts), GUI apps, dotfiles via symlinks e configuracoes especificas do SO.

Estrutura do Repositorio

braia-os/
├── bootstrap.sh             # Entry point macOS / Linux
├── bootstrap.ps1            # Entry point Windows
├── shared/
│   ├── manifest.json        # Fonte de verdade: pacotes, configs, equivalencias
│   ├── install/             # Scripts modulares (packages, shell, fonts, dotfiles, apps, git)
│   └── configs/             # Configs cross-platform (starship, atuin, tmux, btop, git, zed, alacritty)
├── macos/
│   ├── install.sh           # macOS defaults + services + Brewfile
│   ├── Brewfile             # Snapshot completo do Homebrew
│   └── configs/             # AeroSpace, skhd, SketchyBar, borders, kanata, autoraise
├── linux/
│   ├── install.sh           # Hyprland stack + pipewire + AUR
│   └── configs/             # Hyprland, Waybar, wofi, dunst, kanata
├── windows/
│   ├── install.ps1          # Chocolatey + GlazeWM + PowerToys
│   └── configs/             # GlazeWM, kanata, PowerToys
├── personal/
│   ├── config/              # App/terminal configs com symlink system (mappings.json)
│   ├── scripts/             # install.sh, backup.sh, status.sh, uninstall.sh
│   ├── env/                 # Environment vars por projeto
│   └── obsidian/            # Knowledge base
└── *.html                   # Documentacao interativa (Lotion design system)