No description
  • Go 99.5%
  • Makefile 0.5%
Find a file
2026-06-14 03:09:01 +01:00
.agent/claude chore: add and reconcile opencode agent harness 2026-06-14 01:32:20 +01:00
.build-plan chore: add and reconcile opencode agent harness 2026-06-14 01:32:20 +01:00
.opencode chore: sync residual agent and skill configs 2026-06-14 03:09:01 +01:00
cmd refactor(core): move all library packages into lib/ 2026-06-08 20:43:57 -07:00
etc/pam.d unfuck claude comitting to /home/user and not project 2026-03-28 17:45:48 +00:00
lib feat(core/config): add LoadOne and WriteTo helpers 2026-06-12 21:16:24 -07:00
magefiles refactor(console): consolidate scroll helpers, DECOM wrappers, and cursor positioning 2026-04-03 00:22:29 +01:00
systemd unfuck claude comitting to /home/user and not project 2026-03-28 17:45:48 +00:00
.gitignore chore: update .gitignore (add residual-theme, residual-demo; remove residual-edit) 2026-06-08 18:02:10 -07:00
ARCHITECTURE.md refactor(core): move all library packages into lib/ 2026-06-08 20:43:57 -07:00
CLAUDE.md feat(editor): keybind additions, keymap doc, and filepicker rewrite 2026-03-30 01:10:44 +01:00
go.mod exp magefile support 2026-03-30 13:15:24 -07:00
go.sum exp magefile support 2026-03-30 13:15:24 -07:00
Makefile add themes tool 2026-05-03 12:15:01 -07:00
README refactor(core): move all library packages into lib/ 2026-06-08 20:43:57 -07:00

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