architecture

Document the nyxterm architecture, covering backend and frontend technologies, PTY handling, and IPC contracts.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/FullFran/nyxterm --skill architecture-fullfran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/FullFran/nyxterm/tree/main/.agents/skills/architecture
Command: npx skills add https://github.com/FullFran/nyxterm --skill architecture-fullfran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive guide to the architecture and design of nyxterm, aiding developers in understanding its underlying structure and component interactions.

Core Features & Use Cases

  • Stack Overview: Details the backend (Rust, Tauri 2, portable-pty) and frontend (React 18, TypeScript, xterm.js) technologies used.
  • Module Shape: Describes the organization of the codebase into modules like pty, multiplex, shell, fs, theme, and ai.
  • PTY Wiring: Explains the internal handling of PTY sessions, including reader, flusher, and waiter threads.
  • IPC Contract: Outlines the command and channel interfaces between the frontend and backend.
  • Rendering: Discusses the use of WebGLAddon for GPU rendering and the renderer pool for efficient xterm instance management.
  • What Lives Where: Maps concerns like PTY syscalls and theme palette to their respective layers and components.
  • Change Management: Describes the process for updating architectural changes and documentation.
  • Use Case: Ideal for developers integrating with nyxterm or extending its capabilities.

Quick Start

Load the architecture skill to explore the overall stack and module shape of nyxterm.

Frequently Asked Questions about architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does PTY session handling work in a Tauri terminal application?

PTY session handling in a Tauri terminal uses portable-pty on the backend, managed through dedicated reader, flusher, and waiter threads to process terminal data streams efficiently.

Can I use WebGLAddon for GPU rendering with xterm.js in a React 18 project?

WebGLAddon enables GPU rendering with xterm.js in a React 18 project, utilizing a renderer pool to efficiently manage xterm instances and optimize terminal display performance.

How do I organize modules for a terminal emulator using Rust and React?

Organizing a Rust and React terminal emulator involves structuring modules like pty, multiplex, shell, fs, theme, and ai to map specific concerns to their respective layers and components.

Does the nyxterm architecture documentation cover how to update architectural changes?

The nyxterm architecture documentation outlines a change management process for updating architectural changes and maintaining documentation accuracy when extending terminal capabilities.

What is the best way to understand the full stack architecture of a xterm.js and Rust terminal?

Understanding a xterm.js and Rust terminal architecture requires mapping the full stack, from PTY syscalls and theme palettes to frontend rendering strategies and IPC command interfaces.