internal/

Package app is noct's workspace, run by the daemon: the home screen, tabs of panes, noct mode, the render loop and the terminal attached to it.

Package client is the side of noct that runs in the user's terminal: it attaches that terminal to the daemon, forwarding keys and size changes and writing what the daemon draws.

Package config loads and saves the user's settings file.

Package daemon runs the background process that owns noct's workspace, and starts it on demand.

Package flow chains scripts into flows: steps with conditions, repetitions, waits and captures of their output, kept as YAML (see docs/fluxos.md).

Package ipc is the protocol between the noct daemon and the terminals attached to it: length-prefixed messages over a Unix socket.

Package kittygfx lets programs in panes show images with kitty's graphics protocol: their image commands become images in the outer terminal, displayed through Unicode placeholder cells that live in the pane's text, so images scroll, clip and clear along with it.

Package layout arranges the panes of a tab the way i3 does: a tree of containers, each laying its children side by side or stacked, with a share of the container for each child.

Package logstore keeps what programs in panes print on disk, so it outlives the screen.

Package mcp is noct's MCP server: it lets an AI list, read, draft, run and follow scripts and flows, and see and use the workspace's panes, within the user's policy (see docs/mcp.md).

Package pane runs one program in a pseudo-terminal and keeps its screen in a VT emulator.

Package pty starts programs attached to pseudo-terminals.

Package schedule decides when flows start by themselves: on their cron schedule, when the files they watch change, or after another flow ends.

Package script loads the scripts users keep in noct: a command line with parameters and notes, stored as plain files so they can be edited, versioned and shared.

Package session keeps noct's sessions on disk: the tabs and panes of each, to open them again after they were closed or the workspace stopped.

Package update finds noct's releases on GitHub, with the changelog of each, and replaces the noct binary with a newer release.