arct-cli 0.2.0

Arc Academy Terminal - Learn shell commands interactively with AI-powered explanations
Documentation

Arc Academy Terminal

Learn shell commands interactively with AI-powered explanations

License: MIT Rust Website

Arc Academy Terminal is a modern, interactive TUI (Terminal User Interface) that helps you learn shell commands through real-time explanations, AI assistance, and hands-on practice.

Features

  • Interactive Lessons - Learn Linux/Bash step-by-step with guided lessons (Press Ctrl+L)
    • Safe virtual filesystem sandbox for practice
    • Real-time directory tree visualization
    • Hands-on exercises with instant validation
  • Interactive Shell - Execute commands and see live output with ANSI color support
  • Real-time Learning - Get instant explanations for every command you run
  • AI Assistant - Ask questions about shell commands using OpenAI, Anthropic, or local LLMs
  • Progress Tracking - Skill levels, daily streaks, and achievement tracking
  • Smart Autocomplete - Tab completion for commands and file paths
  • Command History - Navigate through your command history with arrow keys
  • Shell Builtins - Built-in cd, history, export, and alias commands
  • Beautiful Themes - Multiple color schemes (Orange, Green, Dark, Light)
  • Privacy-First Analytics - Local-only progress tracking with SQLite
  • Session Persistence - Your history and configuration are saved between sessions

Installation

Quick Install (Recommended)

One command - installs Rust automatically if needed:

curl -fsSL https://arcacademy.sh/install.sh | bash

This script will:

  • ✅ Detect your platform (Linux/macOS/Windows)
  • ✅ Install Rust/Cargo if not already installed
  • ✅ Install Arc Academy Terminal from crates.io
  • ✅ Configure your PATH automatically

Alternative: Cargo (if you already have Rust)

cargo install arct-cli

From Source

git clone https://github.com/metarobb/arc-academy-terminal.git
cd arc-academy-terminal
cargo install --path crates/arct-cli

Development Version

cargo install --git https://github.com/metarobb/arc-academy-terminal arct-cli

Quick Start

# Start the interactive TUI
arct

# Show version
arct --version

# Get command explanation (non-interactive)
arct explain "ls -lah"

Using Lessons

Arc Academy Terminal includes interactive lessons that teach you shell commands in a safe, sandboxed environment:

  1. Start a lesson: Press Ctrl+L to enter lesson mode
  2. Follow along: The lesson panel guides you through each step
  3. Practice safely: Navigate a virtual filesystem that won't affect your real system
  4. See your progress: Watch the directory tree update in real-time as you practice commands
  5. Exit lessons: Press Ctrl+L again to return to normal mode

Available lessons:

  • Navigation Basics - Learn pwd, cd, and ls commands with hands-on practice

Keyboard Shortcuts

  • Ctrl+L - Toggle lesson mode
  • Ctrl+A - Toggle AI assistant
  • Ctrl+T - Cycle through themes
  • Ctrl+S - Open settings
  • ? - Show help
  • q or Ctrl+C - Quit
  • Tab - Switch between panels / Autocomplete commands
  • ↑/↓ - Navigate command history or scroll output

Configuration

Configuration file: ~/.config/arct/config.toml

See the full documentation for configuration options.

License

MIT License

Links

Learn by doing. Master the terminal with Arc Academy.