CyRun

A modern terminal-based REPL with syntax highlighting, command history, and background execution.

Features

• Beautiful terminal UI with Dracula theme
• Command syntax highlighting as you type
• Persistent command history
• Background command execution
• Multi-line input with scrolling
• Tab completion for files and directories
• Output scrolling for long command results
• ANSI color support for command output

Installation

Prerequisites

• Rust toolchain (1.70+)
• Terminal with true color and Unicode support

Building from source

# Clone the repository
git clone https://github.com/yourusername/cyrun.git
cd cyrun

# Build and run
make build
make run

# Or install globally
make install

Usage

CyRun provides a simple REPL interface for running shell commands.

Basic Commands

• Type any shell command and press Enter to execute
• Use Up/Down arrows to navigate command history
• Use Tab for file path completion
• Shift+Enter for multi-line input
• Ctrl+C or Ctrl+Q to quit

Special Commands

• /help or :h - Show help message
• /clear or :c - Clear command history
• /repl or :r - Switch to REPL view
• /jobs or :j - Switch to jobs view
• /logs or :l - Switch to logs view
• /quit or :q - Exit application

Navigation

• Tab to switch between views in tab mode
• Up/Down to navigate entries or command history
• Ctrl+Up/Down to scroll history
• PageUp/PageDown for faster scrolling

Development

Project Structure

• src/main.rs - Application entry point and event loop
• src/app/ - Application state and logic
• src/ui/ - UI components and rendering
• src/executor/ - Command execution logic
• src/highlighting/ - Syntax highlighting

Building and Testing

# Check for errors
make check

# Run with debug information
make debug

# Clean build artifacts
make clean

License

MIT