- Go 99.2%
- Lua 0.7%
- Makefile 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Update agent handoff/notes/todo docs to match. Binary naming convention: - residual-init: system-level init daemon - residual-login: login manager (not a res subcommand) - All others: res-* |
||
| .agent/claude | ||
| .opencode | ||
| cmd | ||
| internal/libs | ||
| lib | ||
| magefiles | ||
| .gitignore | ||
| ARCHITECTURE.md | ||
| CLAUDE.md | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
residual/core
shared library for the residual toolsuite. no binaries — import this.
libraries (under lib/):
lib/ansi/ ANSI/VT escape sequence constants and helpers
lib/config/ TOML config loading (system + user, merged)
lib/defaults/ numeric and string constants shared across repos
lib/ipc/ JSON-over-UNIX-socket RPC client/server
lib/lock/ singleton lock via UNIX socket
lib/log/ dual-output logger (stderr + timestamped file)
lib/proc/ process groups, graceful shutdown, reaper
lib/pty/ PTY session management, VT screen buffer, shell detection
lib/script/ Lua VM factory (gopher-lua) + safe res-core stdlib
lib/script/system/ unsafe extensions (exec, write_file, has_service)
lib/tui/theme/ amber palette, lipgloss styles, TOML config, OSC sequences
lib/tui/list/ scrollable cursor list, RenderListRow, FilterContains
lib/tui/overlay/ help overlay rendering (HelpSection, RenderHelpOverlay)
lib/tui/widget/ Widget interface for status bar widgets
lib/util/ path helpers (home dir, ~ expansion, CWD shortening)
lib/xdg/ freedesktop .desktop session + app discovery
docs/aesthetic.md color scheme and ui philosophy (applies to everything) docs/os.md the residual os (alpine-based, future work) docs/tooling.md original tooling overview (pre-split reference) docs/console.md console user reference docs/console-design.md console internals docs/keymap.md keybindings across all tools docs/scripting.md lua scripting api
module: git.merith.xyz/residual/core language: go 1.25