Menu
Executa a Fase 7 do refactor Kryonix — Kryonix Shell WM-first (Hyprland + Qt/QML + Rust + Home Manager). Use quando o usuário pedir para construir o shell próprio do Kryonix sobre Hyprland, kryonix-shell-daemon, kryonix-shell-ui, sddm-kryonix-theme puro (sem KDE), ou trabalhar na Fase 7.
Executa a Fase 8 do refactor Kryonix — Kryonix Aurora Shell (camada de experiência sobre KDE Plasma 6: theme engine, bar, control center, SDDM, perfis declarativos e HM sync bridge). Use quando o usuário pedir para customizar o KDE como produto próprio, kryonix-control-center, Aurora Shell, transparência KDE, perfis KDE declarativos, ou trabalhar na Fase 8.
Padrões de qualidade e segurança para modificar configurações NixOS/flake. Use esta skill SEMPRE que for editar qualquer arquivo .nix, mudar Display Manager, mexer em opções de Wayland/Hyprland/UWSM, atualizar inputs do flake, ou criar módulos novos. Também use ao revisar diffs antes de commitar ou ao diagnosticar black screen / TTY inacessível após nixos-rebuild. Esta skill define o contrato mínimo de qualidade — nenhuma mudança deve ser feita sem seguir este processo.
External project skill — not related to kryonix internals. Use for data platform and analytics work on external projects (ETL/ELT pipelines, dbt, Airflow, Spark, Kafka, DuckDB, ClickHouse, data lakes, data warehouses). Not applicable to kryonix homelab operations.
Diagnostica e reduz lentidão percebida em Hyprland/Caelestia no kryonix — launches lentos, animações excessivas, custo de blur/transparência e problemas de shell. Use quando o usuário reportar lentidão visual, animações pesadas, blur caro, travadas no Caelestia ou dúvida entre bug de launcher e custo gráfico do rice no glacier ou inspiron.
Opera o sistema Brain do kryonix — LightRAG + Neo4j + Ollama + CAG no glacier. Use quando a tarefa envolver kryonix brain search/ask/index/cag, a API do Brain (porta 8000), indexação de documentos, diagnóstico do grafo de conhecimento, kora (assistente de voz/texto), rotas CAG, ou qualquer problema com os serviços kryonix-brain-api, kryonix-lightrag ou ollama no glacier.
Encontra e corrige a causa real de apps abrindo errado, lentos ou não abrindo pelo launcher Caelestia no kryonix — problemas com desktop entries, uwsm, app2unit, wrappers e cache. Use quando o usuário reportar regressão no launcher, app abrindo pelo binário errado, falha em uwsm app --, ou dúvida entre desktop entry, wrapper e cache no glacier ou inspiron.
| name | phase7-kryonix-shell |
| description | Executa a Fase 7 do refactor Kryonix — Kryonix Shell WM-first (Hyprland + Qt/QML + Rust + Home Manager). Use quando o usuário pedir para construir o shell próprio do Kryonix sobre Hyprland, kryonix-shell-daemon, kryonix-shell-ui, sddm-kryonix-theme puro (sem KDE), ou trabalhar na Fase 7. |
| allowed-tools | Read, Write, Edit, Bash(nix build:*), Bash(nix flake check:*), Bash(nix fmt:*), Bash(cargo:*), Bash(rg:*), Bash(find:*), Grep, Glob |
Leia primeiro specs/07-kryonix-shell.md. Esta skill constrói o shell nativo Kryonix
sem KDE: compositor Hyprland, UI em Qt/QML (Quickshell), backend em Rust.
Não confundir com Fase 8 (Aurora Shell = Kryonix sobre KDE Plasma).
Antes de qualquer mudança leia:
packages/kryonix-bar/ — daemon Rust existente (org.kryonix.Bar via D-Bus); é o ponto de partida do daemon, não reinventar do zero.desktop/hyprland/ — estrutura ativa: system.nix, core/, caelestia/, user.nix.lib/options.nix — opções existentes (kryonix.desktop.environment, kryonix.desktop.shell).specs/07-kryonix-shell.md — fonte de verdade das fases (A→G).packages/kryonix-shell-daemon/ ← evolução de kryonix-bar (mantém alias durante PR A)
packages/kryonix-shell-ui/ ← Quickshell + QML (Bar, Launcher, ControlCenter, Settings)
packages/sddm-kryonix-theme/ ← QML SDDM; nunca sem fallback Breeze coinstalado
modules/nixos/desktop/hyprland/shell.nix ← módulo NixOS (desativado por default)
home/<user>/hyprland/shell.nix ← módulo HM atrás de kryonix.desktop.shell=="kryonix"
packages/kryonix-cli/lib/shell.sh ← kryonix shell save [--switch] [--push] [--dry]
rgba(11,15,20,0.72), accent #38BDF8, surface #111827."caelestia".libsForQt5.breeze-qt5 + assertion + doc de rollback no PR.mkOutOfStoreSymlink + kryonix shell save).A: opções lib/options.nix + scaffold daemon (nix build passa; sem efeito visível)
B: IPC Hyprland (.socket2.sock) + persistência TOML + hot-reload inotify
C: kryonix-shell-ui (Bar QML mínima: workspaces + CPU% + RAM% + clock)
D: módulo HM ativa daemon + Quickshell via exec-once
E: kryonix shell save (CLI subcomando)
F: sddm-kryonix-theme opt-in
G: command palette + Brain (opcional)
background: #0B0F14 surface: #111827
surfaceAlt: #1E293B accent: #38BDF8
text: #E5E7EB muted: #94A3B8
danger: #F43F5E warning: #F59E0B
success: #22C55E panel-alpha: 0.72
nix fmt
nix flake check --keep-going --impure
nix build .#kryonix-shell-daemon --no-link -L
nix build .#kryonix-shell-ui --no-link -L # a partir do PR C
nix build .#nixosConfigurations.inspiron.config.system.build.toplevel --no-link -L
nix build .#nixosConfigurations.glacier.config.system.build.toplevel --no-link -L
nix build .#homeConfigurations."rocha@inspiron".activationPackage --no-link -L
kryonix test # antes de qualquer switch
Smoke (host de teste, NUNCA inspiron produtivo de primeira):
journalctl --user -u kryonix-shell-daemon~/.config/kryonix-shell/settings.toml → accent muda em < 1 skryonix shell save → commit em ~/kryonixos/kryonix.desktop.shell = "caelestia" + nixos-rebuild --rollback.services.displayManager.sddm.theme = "breeze" + rollback.systemctl --user stop kryonix-shell-daemon (binário fica inerte).Bloco VIBECODE obrigatório:
Plano / Diff / Teste / Risco / Rollback