Ecossistema
braia-os
Ambiente reproduzivel, cross-platform, keyboard-driven. Configuracao unificada para macOS, Linux e Windows.
182
Packages
25+
CLI Tools
3
SOs
11
Configs
Distribuicao de Ferramentas por Camada
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
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 | Waybar | GlazeWM bar |
| Hotkeys | skhd | Hyprland binds | GlazeWM binds |
| Key Remap | Kanata + hidutil | 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) | ||
Camada Core
Desktop macOS
Desktop Linux (Arch)
Desktop Windows
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)Mapa de Keybindings Unificado
Window Management
alt + h j k lFocus left/down/up/rightalt + shift + h j k lMove windowalt + 1-9Switch workspacealt + fFullscreenalt + shift + fFloat toggleKanata Layers
caps (tap)Entercaps (hold)Left Shiftspace (hold) + h/lHome / Endspace (hold) + a/c/x/zCmd+A/C/X/Z; (tap/hold)Space / EnterApp Launchers (skhd)
cmd + returnOpen Kittyalt + cmd + kReload SketchyBaralt + shift + rReload AeroSpace + barsTmux (prefix Ctrl+A)
cmd + alt + returnNew window| / -Split V / Hh j k lNavigate panesKeyboard Config Interativo
Visualize todas as teclas remapeadas por layer com detalhes do Kanata
Quick Start — Bootstrap
Boota pelo Ventoy USB, escolhe o SO, instala, e depois executa:
git clone <repo> ~/braia-os
cd ~/braia-os
./bootstrap.shgit clone <repo> ~/braia-os
cd ~/braia-os
./bootstrap.shgit clone <repo> ~\braia-os
cd ~\braia-os
.\bootstrap.ps1O 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.