feat(cli): add interactive install TUI wizard

- Add inquire, indicatif, console crates for interactive prompts
- Create tui module with custom theme, banner, and UI helpers
- Implement wizard flow with project detection and multi-select
- Add -y/--yes flag to skip interactive mode
- Maintain backward compatibility with existing flag-based usage

Author: nguyenphutrong

Cargo.lock

@@ -47,6 +47,11 @@ schemars = "1.2"
 tiktoken-rs = "0.9"
 uuid = { version = "1", features = ["v4"] }
 
+# Interactive TUI
+inquire = "0.7"
+indicatif = "0.17"
+console = "0.15"
+
 [dev-dependencies]
 tempfile = "3"
 assert_cmd = "2"

Cargo.toml

@@ -27,6 +27,9 @@ pub enum Command {
         /// Generate AI tool templates (cursor, claude, opencode, or all)
         #[arg(long, value_name = "TOOLS")]
         templates: Option<Option<String>>,
+        /// Skip interactive mode, use defaults
+        #[arg(long, short = 'y')]
+        yes: bool,
     },
     /// Start MCP server for AI tool integration
     Serve {

src/cli/args.rs

@@ -4,6 +4,7 @@ mod hooks;
 mod serve;
 mod telemetry;
 mod templates;
+pub mod tui;
 mod update;
 mod watch;
 
@@ -13,5 +14,6 @@ pub use hooks::{install_hooks, install_hooks_with_manager, remove_hooks};
 pub use serve::{run_mcp_http_server, run_mcp_server};
 pub use telemetry::{run_telemetry_all_modules, run_telemetry_module, run_telemetry_summary};
 pub use templates::run_templates;
+pub use tui::{execute_setup, is_interactive, run_interactive_init, InitOptions};
 pub use update::run_update;
 pub use watch::run_watch;

src/cli/mod.rs

@@ -0,0 +1,7 @@
+mod theme;
+mod wizard;
+
+pub use theme::agentlens_theme;
+pub use wizard::{
+    execute_setup, is_interactive, run_interactive_init, InitOptions, TemplateChoice,
+};

src/cli/tui/mod.rs

@@ -0,0 +1,67 @@
+use console::style;
+use inquire::ui::{Attributes, Color, RenderConfig, StyleSheet, Styled};
+
+pub fn agentlens_theme() -> RenderConfig<'static> {
+    let mut config = RenderConfig::default();
+
+    config.prompt_prefix = Styled::new("?").with_fg(Color::LightCyan);
+    config.highlighted_option_prefix = Styled::new("❯").with_fg(Color::LightCyan);
+    config.selected_checkbox = Styled::new("◉").with_fg(Color::LightGreen);
+    config.unselected_checkbox = Styled::new("○").with_fg(Color::DarkGrey);
+    config.answer = StyleSheet::new().with_fg(Color::LightCyan);
+    config.help_message = StyleSheet::new()
+        .with_fg(Color::DarkGrey)
+        .with_attr(Attributes::ITALIC);
+
+    config
+}
+
+pub fn print_banner() {
+    println!();
+    println!(
+        "  {}  {}",
+        style("🔍").cyan(),
+        style("agentlens").cyan().bold()
+    );
+    println!("  {}", style("Interactive Setup").dim());
+    println!();
+}
+
+pub fn print_success(message: &str) {
+    println!("  {} {}", style("✓").green(), message);
+}
+
+pub fn print_error(message: &str) {
+    println!("  {} {}", style("✗").red(), message);
+}
+
+pub fn print_summary() {
+    println!();
+    println!("{}", style("─".repeat(50)).dim());
+    println!();
+    println!(
+        "  {} {}",
+        style("✅").green(),
+        style("Setup complete!").green().bold()
+    );
+    println!();
+    println!("  {}", style("Next steps:").bold());
+    println!(
+        "    {} Run {} to generate documentation",
+        style("1.").dim(),
+        style("agentlens").cyan()
+    );
+    println!(
+        "    {} Add {} to .gitignore (or commit for team)",
+        style("2.").dim(),
+        style(".agentlens/").cyan()
+    );
+    println!(
+        "    {} Read {} for AI navigation",
+        style("3.").dim(),
+        style(".agentlens/INDEX.md").cyan()
+    );
+    println!();
+    println!("  {} 🚀", style("Happy coding!").dim());
+    println!();
+}