Huehat · Modules

Small pieces, wired into one shell

Every block here is a real module: a bar widget, a small daemon, a helper binary or a bit of glue around Hyprland. This page is half documentation for me, half map for anyone curious about what Huehat actually runs.

Tags: Core, Alpha, Dev, Native, Upcoming.

Sections

Modules32 loaded

AINative

v0.02

Kira AI

Runs local models (3B/7B) with different adapters for chat and SAFE terminal plans.

Keeps its own memory per terminal tab and per session instead of mixing everything.

Knows about Hyprland + cwd + last command, not just plain text chat.

Assistant for chat, terminal tips, and widgets.

Rough mental model4 steps

Dispatcher

Decides if a prompt is chat, terminal, or ignore based on context.

Chat mode

Normal conversation plus summarised memory and terminal snapshot.

Terminal mode

Builds SAFE JSON plans that the terminal agent runs step by step.

Feedback

Execution results go back into KiraBrain and memory for the next turn.

Kira · Terminal pipeline

[User] → HueHat Terminal (VTE)
  └─ kira_chat (_AIChatView)
      └─ ask(): merges context (cwd/user/last_cmd/safe flags) → POST /v1/responses
          └─ FastAPI: unpack + set/clear terminal_context → brain.stream(force_mode)
              └─ Dispatcher classifies {chat | terminal | ignore}
                  ├─ chat: context window + chat adapter → reply → UI/TTS; clears plan if needed
                  └─ terminal: SAFE prompt + memory → terminal adapter (JSON plan)
                      └─ stores active_plan → render plan → _execute_safe_plan
                          ├─ actions → FIFO → __kira_run executes → __KIRA_DONE
                          ├─ /terminal/result updates terminal_context and summaries
                          └─ on error → show failure + retry prompt, sync cwd
              └─ next ask reuses terminal_context (last_cmd/exit/plan_pending)

This is roughly how a prompt travels from the bar into the model and back, either as a normal reply or as a SAFE plan. It's documentation for me first, but if you enjoy seeing the cables, this is the actual wiring.