feat: add comprehensive configuration management for interactive mode (#10)

* feat: add comprehensive configuration management for interactive mode

- Add InteractiveConfig struct with mode, prompt, timestamps, and prefix settings
- Support global and per-cluster interactive configuration in config.yaml
- CLI arguments override configuration file settings
- Add configuration save/update functionality with preferences persistence
- Support customizable command prefixes for special commands
- Update documentation in --help, README.md, and manpage
- Add tests for configuration loading, merging, and saving

* fix: add missing fields to InteractiveCommand struct initialization in tests

* update: remove osv-scanner since it does not work

Author: inureyes

.github/workflows/osv-scanner.yml

@@ -198,13 +198,36 @@ defaults:
   ssh_key: ~/.ssh/id_rsa
   parallel: 10
 
+# Global interactive mode settings (optional)
+interactive:
+  default_mode: multiplex        # single_node or multiplex
+  prompt_format: "[{node}] $ "   # Variables: {node}, {user}, {host}, {pwd}
+  history_file: ~/.bssh_history
+  show_timestamps: false         # Show timestamps in output
+  work_dir: /home/admin          # Initial working directory
+  broadcast_prefix: "!all "      # Prefix for broadcasting to all nodes
+  node_switch_prefix: "!"        # Prefix for special commands
+  colors:                        # Node-specific colors in output
+    node1: red
+    node2: blue
+    node3: green
+  keybindings:
+    switch_node: "Ctrl+N"
+    broadcast_toggle: "Ctrl+B"
+    quit: "Ctrl+Q"
+
 clusters:
   production:
     nodes:
       - web1.example.com
       - web2.example.com
       - user@web3.example.com:2222
     ssh_key: ~/.ssh/prod_key
+    # Cluster-specific interactive settings (overrides global)
+    interactive:
+      default_mode: single_node
+      prompt_format: "prod> "
+      work_dir: /var/www
 
   staging:
     nodes:
@@ -282,6 +305,38 @@ bssh -H server1,server2 interactive --prompt-format "{user}@{host}> "
 bssh -c staging interactive --work-dir /var/www
 ```
 
+#### Interactive Mode Configuration
+
+Interactive mode can be configured in your `config.yaml` file with both global and per-cluster settings. CLI arguments always override configuration file settings.
+
+**Global Configuration** (applies to all clusters unless overridden):
+```yaml
+interactive:
+  default_mode: multiplex        # or single_node
+  prompt_format: "[{node}] $ "
+  history_file: ~/.bssh_history
+  show_timestamps: true          # Add timestamps to output
+  work_dir: /home/user
+  broadcast_prefix: "!all "      # Custom prefix for broadcast commands
+  node_switch_prefix: "!"        # Custom prefix for special commands
+```
+
+**Per-Cluster Configuration** (overrides global settings):
+```yaml
+clusters:
+  production:
+    interactive:
+      default_mode: single_node  # Different mode for this cluster
+      prompt_format: "PROD> "
+      work_dir: /var/app
+```
+
+**Configuration Priority**:
+1. CLI arguments (highest priority)
+2. Cluster-specific configuration
+3. Global configuration
+4. Built-in defaults
+
 In multiplex mode, commands are sent to active nodes with visual indicators:
 
 ```
@@ -294,7 +349,7 @@ In multiplex mode, commands are sent to active nodes with visual indicators:
 
 #### Interactive Mode Special Commands
 
-Interactive mode supports special commands (starting with `!`) for node management:
+Interactive mode supports special commands for node management. By default, these commands start with `!` but the prefix can be customized in the configuration file.
 
 | Command | Description |
 |---------|-------------|
@@ -306,6 +361,13 @@ Interactive mode supports special commands (starting with `!`) for node manageme
 | `!help` or `!?` | Show help for special commands |
 | `exit` | Exit interactive mode |
 
+**Note**: The `!` prefix and `!broadcast` command can be customized via configuration:
+```yaml
+interactive:
+  node_switch_prefix: "@"        # Use @ instead of !
+  broadcast_prefix: "@all "      # Use @all instead of !broadcast
+```
+
 #### Node Indicators in Prompt
 
 The prompt shows node status with visual indicators:

README.md

@@ -116,6 +116,31 @@ Each downloaded file is saved with a unique name prefixed by the hostname.
 Uses SFTP protocol for secure file transfer with progress indicators.
 .RE
 
+.TP
+.B interactive
+Start an interactive shell session on cluster nodes
+.RS
+Usage: bssh interactive [\fIOPTIONS\fR]
+.br
+Opens an interactive shell session with one or more remote hosts. Supports both single-node
+and multiplex modes. In multiplex mode, commands are sent to all active nodes simultaneously.
+.PP
+Options:
+.IP "\-\-single\-node"
+Connect to a single node instead of multiplexing to all nodes
+.IP "\-\-multiplex"
+Multiplex input across all nodes (default behavior)
+.IP "\-\-prompt\-format FORMAT"
+Custom prompt format with variables: {node}, {user}, {host}, {pwd}
+.IP "\-\-history\-file PATH"
+History file path for command history (default: ~/.bssh_history)
+.IP "\-\-work\-dir DIR"
+Initial working directory on remote hosts
+.PP
+Interactive mode settings can be configured globally or per-cluster in the configuration file.
+CLI arguments override configuration file settings.
+.RE
+
 .SH CONFIGURATION
 .B bssh
 loads configuration from the following sources in priority order:
@@ -137,13 +162,28 @@ defaults:
   ssh_key: ~/.ssh/id_rsa
   parallel: 10
 
+# Global interactive mode settings (optional)
+interactive:
+  default_mode: multiplex        # single_node or multiplex
+  prompt_format: "[{node}] $ "   # Variables: {node}, {user}, {host}, {pwd}
+  history_file: ~/.bssh_history
+  show_timestamps: false         # Show timestamps in output
+  work_dir: /home/admin          # Initial working directory
+  broadcast_prefix: "!all "      # Prefix for broadcasting to all nodes
+  node_switch_prefix: "!"        # Prefix for special commands
+
 clusters:
   production:
     nodes:
       - web1.example.com
       - web2.example.com
       - user@web3.example.com:2222
     ssh_key: ~/.ssh/prod_key
+    # Cluster-specific interactive settings (overrides global)
+    interactive:
+      default_mode: single_node
+      prompt_format: "prod> "
+      work_dir: /var/www
 
   staging:
     nodes:
@@ -271,6 +311,50 @@ Download logs with wildcard pattern:
 Downloads all files matching app*.log from /var/log/ on each node
 .RE
 
+.TP
+Start interactive mode with all nodes:
+.B bssh -c production interactive
+.RS
+Opens an interactive shell session with all nodes in multiplex mode
+.RE
+
+.TP
+Start interactive mode with single node:
+.B bssh -c production interactive --single-node
+.RS
+Prompts to select one node for interactive session
+.RE
+
+.TP
+Interactive mode with custom prompt:
+.B bssh -H server1,server2 interactive --prompt-format "{user}@{host}> "
+
+.TP
+Interactive mode with initial working directory:
+.B bssh -c staging interactive --work-dir /var/www
+.RS
+Sets initial working directory to /var/www on all nodes
+.RE
+
+.SS Interactive Mode Special Commands
+When in interactive mode, the following special commands are available (default prefix is !):
+.IP "!all"
+Activate all connected nodes
+.IP "!broadcast <cmd>"
+Execute command on all nodes temporarily
+.IP "!node<N>"
+Switch to node N (e.g., !node1, !node2)
+.IP "!list"
+List all nodes with their connection status
+.IP "!status"
+Show currently active nodes
+.IP "!help"
+Show help for special commands
+.IP "exit"
+Exit interactive mode
+.PP
+Note: The special command prefix can be customized in the configuration file.
+
 .SH EXIT STATUS
 .TP
 .B 0

docs/man/bssh.1

@@ -15,7 +15,7 @@
 //! Example demonstrating interactive mode usage with bssh
 
 use bssh::commands::interactive::InteractiveCommand;
-use bssh::config::Config;
+use bssh::config::{Config, InteractiveConfig};
 use bssh::node::Node;
 use std::path::PathBuf;
 
@@ -46,6 +46,8 @@ async fn main() -> anyhow::Result<()> {
         work_dir: None,
         nodes,
         config: Config::default(),
+        interactive_config: InteractiveConfig::default(),
+        cluster_name: None,
     };
 
     println!("Starting interactive session...");

examples/interactive_demo.rs

@@ -138,36 +138,41 @@ pub enum Commands {
         recursive: bool,
     },
 
-    #[command(about = "Start interactive shell session")]
+    #[command(
+        about = "Start interactive shell session\n\nInteractive mode settings can be configured globally or per-cluster in the configuration file.\nCLI arguments override configuration file settings."
+    )]
     Interactive {
         #[arg(
             long,
-            help = "Connect to a single node instead of multiplexing to all nodes"
+            help = "Connect to a single node instead of multiplexing to all nodes (overrides config)"
         )]
         single_node: bool,
 
         #[arg(
             long,
             default_value = "true",
-            help = "Multiplex input across all nodes (default behavior)"
+            help = "Multiplex input across all nodes (default behavior, overrides config)"
         )]
         multiplex: bool,
 
         #[arg(
             long,
             default_value = "[{node}:{user}@{host}:{pwd}]$ ",
-            help = "Custom prompt format"
+            help = "Custom prompt format with variables: {node}, {user}, {host}, {pwd} (overrides config)"
         )]
         prompt_format: String,
 
         #[arg(
             long,
             default_value = "~/.bssh_history",
-            help = "History file path for command history"
+            help = "History file path for command history (overrides config)"
         )]
         history_file: PathBuf,
 
-        #[arg(long, help = "Initial working directory on remote hosts")]
+        #[arg(
+            long,
+            help = "Initial working directory on remote hosts (overrides config)"
+        )]
         work_dir: Option<String>,
     },
 }