residual

A Linux terminal suite written in Go.

• res-init — userspace init daemon and service manager
• res-console — PTY-based console multiplexer
• res-edit — TUI text editor
• res-sh — custom shell
• res-login — login and session launcher
• res — dispatcher for the res-* binaries

Design

• Amber-on-black everywhere (#ffb000 on #0d0a00).
• Minimal and unix-like: each res-* binary is standalone at runtime.
• Shared logic lives in core/lib/ and is imported as a library.
• Multi-repo workspace: each top-level directory is an independent Go module with its own go.mod and .git/.

Workspace layout

residual/
├── auth/     → res-login
├── console/  → res-console
├── core/     → shared libraries (core/lib/*)
├── docs/     → documentation
├── editor/   → res-edit
├── init/     → res-init
├── res/      → res dispatcher
└── shell/    → res-sh

Quick start

From any repo:

go build ./...
go test ./...

Set up shell integration:

eval "$(res env)"

Documentation

See docs/README.md for the full documentation index, and AGENTS.md for coding-agent conventions.