Iris

Iris is a Rust-first terminal platform for standalone and embedded use.

Windows, Linux, and macOS are first-class targets.

Current Status

As of 2026-04-06, Iris has:

• mature parser, terminal-state, scrollback, and selection foundations in iris-core
• cross-platform PTY/clipboard/IME/keyboard/font foundations in iris-platform
• retained-render and input-routing contract coverage across core/platform/renderer tests
• a bootstrap standalone crate (iris-standalone) with:
  • CLI parsing
  • typed TOML config loading and validation
  • PTY launch planning
  • PTY runtime wrapper layer

Still open:

• runnable standalone window/event loop integration
• live end-to-end app validation (vim, tmux, VTtest-style interactive checks)
• platform packaging/integration tasks

Workspace

• iris-core: parser, terminal state, grid, damage, scrollback, selection
• iris-platform: PTY, clipboard, IME, keyboard, mouse/input routing, fonts, DPI
• iris-render-wgpu: renderer pipelines and retained-update paths
• iris-standalone: standalone bootstrap/runtime composition layer

Active Focus

Current work is on standalone runtime completion:

• complete PTY session wiring into a runnable terminal surface
• integrate window events, rendering, and terminal update loops
• execute the platform validation matrix on runnable binaries

Verification

Common verification commands:

cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test --all

Targeted standalone checks:

cargo clippy -p iris-standalone --all-targets -- -D warnings
cargo test -p iris-standalone

Workflow

• main: promotion/stabilization branch
• dev: active integration branch
• feature/*: focused implementation branches created from dev

Normal development flow is feature/* -> dev via pull request. main is promoted deliberately from integration-ready dev state.

Documentation

• docs/README.md
• docs/phases.md
• docs/design.md
• docs/implementation.md
• docs/testing-strategy.md
• docs/security-threat-model.md
• CHANGELOG.md