recli_roadmap.md

Recli Roadmap

---

Phase 0: Setup

• Install Rust and cargo
• Finish Rustlings (in progress)
• Create new binary crate: recli
• Add clap with subcommands for better control

Phase 1: MVP

• Run basic shell passthrough with PTY
• Intercept Ctrl+X with crossterm
• Print "Hotkey detected!" as test
• Add CLI subcommands (start, stop, status, recent, clear)

Phase 2: Terminal Buffer & Command Log

• Create CommandEntry and CommandLog data structures
• Implement command logging methods (start_command, append_output, finish_command)
• Integrate command detection with PTY output parsing
• Include cwd and exit code per command (structures ready)
• Save history to structured log (methods ready)
• Create session management system
• Implement safe log directory creation (~/.recli/logs/)
• Add JSON serialization for terminal logs
• Create start/stop commands with session state tracking

Phase 3: Cloud Database Integration

• Azure Cosmos DB integration with connection string parsing
• Automatic session upload on completion
• Environment-based configuration (.env support)
• Connection diagnostics (cosmos_doctor command)
• Robust error handling and retry logic
• Full context command capture and cloud storage

Phase 4: Context Summarizer

• On hotkey, scan recent commands and extract:
  • All error: lines
  • All non-zero exit codes
• Display interactive summary (e.g., with ratatui)

Phase 5: Command Impact Tracker

• Detect canceling commands
• Mark files added/removed (with snapshots or inotify)
• Show final list of commands that changed system state

Phase 6: Regex Assistant

• Add CLI to pass sample lines
• Suggest regex statically
• Test regex on scrollback buffer

Phase 7: AI Integration

• Add optional LLM support (OpenAI, local)
• Format prompt with context summary
• Show AI-suggested fix
• Optional: inject fix into shell stream

Phase 8: journalctl Log Watcher

• Spawn thread running journalctl -f
• Parse key failures, tag timestamps
• Display relevant logs with command timeline

---