feat(repl): bring REPL to feature parity with ZSH shell plugin

crates/forge_infra/src/fs_read_dir.rs

@@ -37,6 +37,7 @@ impl ForgeDirectoryReaderService {
             .cwd(directory.to_path_buf())
             .max_depth(1)
             .skip_binary(true)
+            .hidden(true)
             .get()
             .await?;
 

crates/forge_infra/src/walker.rs

@@ -16,7 +16,8 @@ impl ForgeWalkerService {
             && config.max_files.is_none()
             && config.max_total_size.is_none()
         {
-            forge_walker::Walker::max_all()
+            // Agent-facing walker: keep hidden files excluded by default.
+            forge_walker::Walker::max_all().hidden(true)
         } else {
             forge_walker::Walker::min_all()
         };

crates/forge_main/Cargo.toml

@@ -38,7 +38,6 @@ lazy_static.workspace = true
 reedline.workspace = true
 crossterm = "0.29.0"
 nu-ansi-term.workspace = true
-nucleo.workspace = true
 tracing.workspace = true
 chrono.workspace = true
 serde_json.workspace = true

crates/forge_main/src/banner.rs

@@ -46,8 +46,8 @@ impl fmt::Display for DisplayBox {
 ///
 /// # Arguments
 ///
-/// * `cli_mode` - If true, shows CLI-relevant commands with `:` prefix. If
-///   false, shows all interactive commands with `/` prefix.
+/// * `cli_mode` - If true, shows CLI-relevant commands. Both interactive and
+///   CLI modes use `:` as the canonical command prefix.
 ///
 /// # Environment Variables
 ///
@@ -76,12 +76,12 @@ pub fn display(cli_mode: bool) -> io::Result<()> {
     } else {
         // Interactive mode: show all commands
         vec![
-            ("New conversation:", "/new"),
-            ("Get started:", "/info, /usage, /help, /conversation"),
-            ("Switch model:", "/model"),
-            ("Switch agent:", "/forge or /muse or /agent"),
-            ("Update:", "/update"),
-            ("Quit:", "/exit or <CTRL+D>"),
+            ("New conversation:", ":new"),
+            ("Get started:", ":info, :usage, :help, :conversation"),
+            ("Switch model:", ":model"),
+            ("Switch agent:", ":forge or :muse or :agent"),
+            ("Update:", ":update"),
+            ("Quit:", ":exit or <CTRL+D>"),
         ]
     };
 

crates/forge_main/src/cli.rs

@@ -366,6 +366,13 @@ pub enum ListCommand {
         #[arg(long)]
         custom: bool,
     },
+
+    /// List files and directories in the current workspace.
+    ///
+    /// Includes hidden files and directories (dotfiles), respects .gitignore,
+    /// and outputs one path per line. Directories are suffixed with `/`.
+    #[command(alias = "files")]
+    File,
 }
 
 /// Shell extension commands.

crates/forge_main/src/completer/command.rs

@@ -1,8 +1,20 @@
 use std::sync::Arc;
 
+use forge_select::ForgeWidget;
 use reedline::{Completer, Span, Suggestion};
 
-use crate::model::ForgeCommandManager;
+use crate::model::{ForgeCommand, ForgeCommandManager};
+
+/// A display wrapper for `ForgeCommand` that renders the name and description
+/// side-by-side for fzf.
+#[derive(Clone)]
+struct CommandRow(ForgeCommand);
+
+impl std::fmt::Display for CommandRow {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        write!(f, "{:<30} {}", self.0.name, self.0.description)
+    }
+}
 
 #[derive(Clone)]
 pub struct CommandCompleter(Arc<ForgeCommandManager>);
@@ -15,35 +27,65 @@ impl CommandCompleter {
 
 impl Completer for CommandCompleter {
     fn complete(&mut self, line: &str, _: usize) -> Vec<reedline::Suggestion> {
-        self.0
+        // Determine which sentinel the user typed (`:` or `/`), defaulting to `/`.
+        let sentinel = if line.starts_with(':') { ':' } else { '/' };
+
+        // Build the list of display names using the same sentinel the user typed.
+        let commands: Vec<CommandRow> = self
+            .0
             .list()
             .into_iter()
             .filter_map(|cmd| {
-                // For command completion, we want to show commands with `/` prefix
                 let display_name = if cmd.name.starts_with('!') {
-                    // Shell commands already have the `!` prefix
                     cmd.name.clone()
                 } else {
-                    // Add `/` prefix for slash commands
-                    format!("/{}", cmd.name)
+                    format!("{}{}", sentinel, cmd.name)
                 };
 
-                // Check if the display name starts with what the user typed
+                // Only include commands that match what the user has typed so far.
                 if display_name.starts_with(line) {
-                    Some(Suggestion {
-                        value: display_name,
-                        description: Some(cmd.description),
-                        style: None,
-                        extra: None,
-                        span: Span::new(0, line.len()),
-                        append_whitespace: false,
-                        match_indices: None,
-                        display_override: None,
-                    })
+                    Some(CommandRow(ForgeCommand {
+                        name: display_name,
+                        description: cmd.description,
+                        value: cmd.value,
+                    }))
                 } else {
                     None
                 }
             })
-            .collect()
+            .collect();
+
+        if commands.is_empty() {
+            return vec![];
+        }
+
+        // Extract the initial query text (everything after the leading sentinel or
+        // `!`).
+        let initial_query = line
+            .strip_prefix('/')
+            .or_else(|| line.strip_prefix(':'))
+            .or_else(|| line.strip_prefix('!'))
+            .unwrap_or(line);
+
+        let mut builder = ForgeWidget::select("Command", commands);
+        if !initial_query.is_empty() {
+            builder = builder.with_initial_text(initial_query);
+        }
+
+        match builder.prompt() {
+            Ok(Some(row)) => {
+                vec![Suggestion {
+                    value: row.0.name,
+                    description: None,
+                    style: None,
+                    extra: None,
+                    span: Span::new(0, line.len()),
+                    append_whitespace: true,
+                    match_indices: None,
+                    display_override: None,
+                }]
+            }
+            _ => vec![],
+        }
     }
 }