#Redterm

Redterm is a PowerShell-based utility for Windows that spawns a self-logging terminal environment. Designed to function as a seamless drop-in shell, redterm gives users persistent logs, clipboard tailing, and environment snapshots, all while maintaining a native experience with subtle visual cues.

Features

• 🎯 One-child spawning: Prevents infinite loops by ensuring only one child process is spawned.
• 🧠 Rolling log: Maintains a user-defined-size transcript (default 20 MB).
• 📋 Clipboard support: Automatically copies the last 120 log lines for quick paste.
• 📸 Environment capture: One-time snapshot of system info at launch.
• 🔴 Subtle visual cue: Custom red prompt and titlebar.
• 🛠️ CLI configuration:
  • -LogSizeMB <int>: Max log size in megabytes (default: 20)
  • -LogPath <string>: Custom log directory (default: ~/.redterm)
  • -Clipboard:$false: Disables the clipboard tail feature

Installation

# Save redterm.ps1 to a secure location
# Make sure execution policy allows the script
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# Launch redterm
powershell -ExecutionPolicy Bypass -File .\redterm.ps1

Customization Roadmap

Redterm is designed with extensibility in mind. Features coming soon:

• ✅ Runtime configuration via redterm command
• ✅ Periodic environment snapshots alongside activity
• 🔐 Optional encryption for session logs
• 🔄 Update check & self-upgrade logic
• 💼 Monetization hooks & license toggles

Environment Strategy

The environment file (environment.txt) is written once on first boot. In the future, snapshots will be updated in tandem with user activity to ensure accuracy without overloading system resources.

Development Goals

• Lightweight, non-intrusive logging shell for power users
• Low CPU/memory usage during idle
• Clear separation of parent/child context
• Easy integration with Git repositories (including GitHub)
• Production-ready error handling for internal dev, silent for end-users

Long-Term Vision

Redterm should feel like any standard terminal to an end user. Under the hood, it will support:

• Periodic encrypted logs
• Rich CLI and runtime configuration
• Portable GitHub-integration model (optional)
• Smooth developer tooling and testing harnesses

---

For developers using Codex or similar agents, include this repo’s intent and behavior in your model prompt:

You are working with redterm, a Windows-native PowerShell terminal shell that maintains rolling logs, supports environment syncing, and exposes runtime config via CLI. It avoids any cross-platform logic and prioritizes seamless UX with advanced under-the-hood telemetry.

Enjoy seamless session awareness.

🟥 redterm — quietly watching, so you don’t have to.