Sovereign 8s.is mirror of standardgalactic/retro-terminal
  • Rust 92.5%
  • Shell 7%
  • Makefile 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Cogito Ergo Sum 7dc79aa5f9
Some checks failed
CI / ci (push) Has been cancelled
Refactor terminal lab into modular app/commands/demos/render architecture
2026-08-09 01:45:39 -03:00
.github Add manage.sh shell test harness and CI hook 2026-08-09 04:14:25 +00:00
docs Establish template-driven project structure 2026-08-07 15:05:16 -03:00
scripts Fix Cargo metadata and add terminal management tooling 2026-08-09 04:08:59 +00:00
site Establish template-driven project structure 2026-08-07 15:05:16 -03:00
src Refactor CLI into app commands demos and render modules 2026-08-09 04:41:49 +00:00
tests/scripts Add manage.sh shell test harness and CI hook 2026-08-09 04:14:25 +00:00
.gitignore Establish template-driven project structure 2026-08-07 15:05:16 -03:00
ACKNOWLEDGEMENTS.md Establish template-driven project structure 2026-08-07 15:05:16 -03:00
AUTHORS.md Establish template-driven project structure 2026-08-07 15:05:16 -03:00
Cargo.lock Implement core terminal state and controls 2026-08-07 18:09:14 +00:00
Cargo.toml Fix Cargo metadata and add terminal management tooling 2026-08-09 04:08:59 +00:00
CHANGELOG.md Establish template-driven project structure 2026-08-07 15:05:16 -03:00
CITATION.cff Establish template-driven project structure 2026-08-07 15:05:16 -03:00
CODE_OF_CONDUCT.md Establish template-driven project structure 2026-08-07 15:05:16 -03:00
CONTRIBUTING.md Establish template-driven project structure 2026-08-07 15:05:16 -03:00
LICENSE Establish template-driven project structure 2026-08-07 15:05:16 -03:00
Makefile Establish template-driven project structure 2026-08-07 15:05:16 -03:00
README.md Add manage.sh shell test harness and CI hook 2026-08-09 04:14:25 +00:00
ROADMAP.md Establish template-driven project structure 2026-08-07 15:05:16 -03:00
SECURITY.md Establish template-driven project structure 2026-08-07 15:05:16 -03:00
STYLE.md Establish template-driven project structure 2026-08-07 15:05:16 -03:00

Retro Terminal

Version

Recreation of historical terminal interfaces, text consoles, and command-line interaction throughout the history of computing.

Current version: 0.1.0

Overview

Retro Terminal explores historical command-line environments as software archaeology. The project recreates terminals, shells, editing environments, communication protocols, and interaction models spanning the early decades of interactive computing.

Current core capabilities

  • Fixed-size screen buffer with row/column cursor tracking.
  • Printable text rendering with line wrapping and vertical scrolling.
  • Control handling: newline, carriage return, tab expansion, cross-line backspace, and clear screen.
  • Command execution API for deterministic terminal state transitions including absolute/relative cursor movement and line clearing.
  • Theme presets inspired by classic displays (amber, green phosphor, and IBM DOS).
  • ANSI CSI support for common cursor movement and clear operations plus SGR style/color controls.
  • Unit tests for wrapping, scrolling, cursor movement, control behavior, ANSI parsing, and style state.

Development

This repository uses a standard make interface:

  • make init
  • make lint
  • make test
  • make benchmark
  • make docs
  • make format
  • make release

Running the interactive terminal demo

Run directly with Cargo:

cargo run

Or use the management script:

./scripts/manage.sh run

Management script

The scripts/manage.sh helper wraps common development and release tasks:

  • ./scripts/manage.sh clean — remove build artifacts
  • ./scripts/manage.sh build — compile debug binary
  • ./scripts/manage.sh run — run the interactive terminal demo
  • ./scripts/manage.sh release — build optimized binary
  • ./scripts/manage.sh version — display current package version
  • ./scripts/manage.sh bump — bump patch version (0.1.0 -> 0.1.1)
  • ./scripts/manage.sh minor — bump minor version (0.1.0 -> 0.2.0)
  • ./scripts/manage.sh major — bump major version (0.1.0 -> 1.0.0)
  • ./scripts/manage.sh lint — run make lint
  • ./scripts/manage.sh test — run make test
  • ./scripts/manage.sh format — run make format
  • ./scripts/manage.sh docs — run make docs

Run the management script smoke test with:

bash tests/scripts/test_manage.sh