Skip to content

Repository files navigation

RITE Logo

RITE

Rust & TypeScript Interface for Terminal Environment

CI Latest Release License

A modern, secure terminal client for SSH and more.


Features

  • Secure by default — Argon2id KDF, ChaCha20-Poly1305 AEAD, zeroized memory
  • Encrypted vault — Local database encrypted at rest
  • SSH client (in development) — Native SSH with xterm.js terminal emulation
  • Host management (in development) — Organize servers with tags and groups

See the Roadmap for planned features (theme system, SFTP, jump hosts, profiles, sync, and more).


Tech Stack

  • Backend: Rust + Tauri 2.x
  • Frontend: React + TypeScript + TailwindCSS
  • Terminal: xterm.js
  • Database: SQLite (encrypted)
  • Crypto: Argon2id, ChaCha20-Poly1305, age
  • SSH: russh (pure Rust)
  • Package Manager: pnpm (monorepo)
  • Build System: Task (go-task)

Platform Support

Platform Status
Linux x86_64 ✅ Primary target
Linux ARM64 ✅ Supported
macOS Intel ✅ Supported
macOS Apple Silicon ✅ Supported
Windows ❌ Not planned

Getting Started

Prerequisites

Development Setup

git clone https://github.com/Altagen/Rite.git
cd Rite
pnpm install
task dev

task dev starts the Vite dev server and the Tauri app with hot-reload.

Before Pushing

Run the full CI check suite locally before every push:

task check

This runs in order: cargo fmt --check, clippy, cargo test, cargo audit, and tsc. Same checks as CI — if it passes locally, it passes on the remote.

Building for Production

task build

See RELEASE.md for the release process.


Configuration

User Data Directories

  • Linux: Config ~/.config/rite/, Data ~/.local/share/rite/
  • macOS: Config & Data ~/Library/Application Support/rite/

Files

Path Purpose
~/.config/rite/config.toml User configuration
~/.config/rite/themes/ Custom themes
~/.local/share/rite/vault.db Encrypted database

Project Structure

rite/
├── apps/
│   └── desktop/          # Tauri desktop application
│       ├── src-tauri/    # Rust backend
│       └── src/          # React frontend
├── packages/
│   ├── crypto/           # Cryptography module (Rust)
│   └── protocols/        # Protocol implementations (Rust)
├── docs/
│   ├── ARCHITECTURE.md
│   ├── RELEASE.md
│   ├── ROADMAP.md
│   └── SECURITY.md
├── Cargo.toml            # Rust workspace
├── pnpm-workspace.yaml
└── Taskfile.yaml

Documentation


Contributing

Issues and bug reports are welcome on GitHub.

For security vulnerabilities, please do not open a public issue. See SECURITY.md.

License

RITE is dual-licensed under:

You may choose either license for your use.

About

No description, website, or topics provided.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages