ngpt 3.12.1__tar.gz → 4.0.0__tar.gz

{ngpt-3.12.1 → ngpt-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ngpt
-Version: 3.12.1
+Version: 4.0.0
 Summary: A Swiss army knife for LLMs: A fast, lightweight CLI and interactive chat tool that brings the power of any OpenAI-compatible LLM (OpenAI, Ollama, Groq, Claude, Gemini, etc.) straight to your terminal. rewrite texts or refine code, craft git commit messages, generate and run OS-aware shell commands.
 Project-URL: Homepage, https://github.com/nazdridoy/ngpt
 Project-URL: Repository, https://github.com/nazdridoy/ngpt
@@ -281,44 +281,21 @@ For more examples and detailed usage, visit the [CLI Usage Guide](https://nazdri
 ```console
 ❯ ngpt -h
 
-usage: ngpt [-h] [-v] [--config [CONFIG]] [--config-index CONFIG_INDEX] [--provider PROVIDER] [--remove] [--show-config]
-            [--all] [--list-models] [--list-renderers] [--cli-config [COMMAND ...]] [--role-config [ACTION ...]]
-            [--api-key API_KEY] [--base-url BASE_URL] [--model MODEL] [--web-search] [--pipe]
+usage: ngpt [-h] [-v] [--api-key API_KEY] [--base-url BASE_URL] [--model MODEL] [--web-search] [--pipe]
             [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
-            [--preprompt PREPROMPT | --role ROLE] [--no-stream | --prettify | --stream-prettify]
+            [--preprompt PREPROMPT | --role ROLE] [--config [CONFIG]] [--config-index CONFIG_INDEX]
+            [--provider PROVIDER] [--remove] [--show-config] [--all] [--list-models] [--list-renderers]
+            [--cli-config [COMMAND ...]] [--role-config [ACTION ...]] [--no-stream | --prettify | --stream-prettify]
             [--renderer {auto,rich,glow}] [--language LANGUAGE] [--rec-chunk] [--diff [FILE]] [--chunk-size CHUNK_SIZE]
             [--analyses-chunk-size ANALYSES_CHUNK_SIZE] [--max-msg-lines MAX_MSG_LINES]
-            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [--multiline] [-i | -s | -c | -t | -r | -g]
-            [prompt]
+            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [-i | -s | -c | -t | -r | -g]
 
 nGPT - Interact with AI language models via OpenAI-compatible APIs
 
-positional arguments::
-
-[PROMPT]                            The prompt to send
-
-options::
+Global Options::
 
 -h, --help                          show this help message and exit
 -v, --version                       Show version information and exit
-
-Configuration Options::
-
---config [CONFIG]                   Path to a custom config file or, if no value provided, enter interactive
-                                    configuration mode to create a new config
---config-index CONFIG_INDEX         Index of the configuration to use or edit (default: 0)
---provider PROVIDER                 Provider name to identify the configuration to use
---remove                            Remove the configuration at the specified index (requires --config and
-                                    --config-index or --provider)
---show-config                       Show the current configuration(s) and exit
---all                               Show details for all configurations (requires --show-config)
---list-models                       List all available models for the current configuration and exit
---list-renderers                    Show available markdown renderers for use with --prettify
---cli-config [COMMAND ...]          Manage CLI configuration (set, get, unset, list, help)
---role-config [ACTION ...]          Manage custom roles (help, create, show, edit, list, remove) [role_name]
-
-Global Options::
-
 --api-key API_KEY                   API key for the service
 --base-url BASE_URL                 Base URL for the API
 --model MODEL                       Model to use
@@ -338,6 +315,21 @@ Global Options::
 --renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify
                                     (auto, rich, or glow)
 
+Configuration Options::
+
+--config [CONFIG]                   Path to a custom config file or, if no value provided, enter interactive
+                                    configuration mode to create a new config
+--config-index CONFIG_INDEX         Index of the configuration to use or edit (default: 0)
+--provider PROVIDER                 Provider name to identify the configuration to use
+--remove                            Remove the configuration at the specified index (requires --config and
+                                    --config-index or --provider)
+--show-config                       Show the current configuration(s) and exit
+--all                               Show details for all configurations (requires --show-config)
+--list-models                       List all available models for the current configuration and exit
+--list-renderers                    Show available markdown renderers for use with --prettify
+--cli-config [COMMAND ...]          Manage CLI configuration (set, get, unset, list, help)
+--role-config [ACTION ...]          Manage custom roles (help, create, show, edit, list, remove) [role_name]
+
 Output Display Options (mutually exclusive)::
 
 --no-stream                         Return the whole response without streaming or formatting
@@ -365,10 +357,6 @@ Rewrite Mode Options::
 --humanize                          Transform AI-generated text into human-like content that passes AI detection
                                     tools
 
-Interactive Mode Options::
-
---multiline                         Enable multiline text input with the "ml" command in interactive mode
-
 Modes (mutually exclusive)::
 
 -i, --interactive                   Start an interactive chat session
@@ -455,37 +443,36 @@ CLI Configuration Help:
     ngpt --cli-config get OPTION          - Get the current value of OPTION
     ngpt --cli-config get                 - Show all CLI configuration settings
     ngpt --cli-config unset OPTION        - Remove OPTION from configuration
-    ngpt --cli-config list                - List all available options
+    ngpt --cli-config list                - List all available options with types and defaults
 
   Available options:
     General options (all modes):
-      config-index - int (default: 0) [exclusive with: provider]
-      log - str 
-      max_tokens - int 
-      no-stream - bool (default: False) [exclusive with: prettify, stream-prettify]
-      preprompt - str 
-      prettify - bool (default: False) [exclusive with: no-stream, stream-prettify]
-      provider - str  [exclusive with: config-index]
-      renderer - str (default: auto)
-      stream-prettify - bool (default: False) [exclusive with: no-stream, prettify]
-      temperature - float (default: 0.7)
-      top_p - float (default: 1.0)
-      web-search - bool (default: False)
-
-    Options for Code generation mode:
-      language - str (default: python)
-
-    Options for Git commit message mode:
-      analyses-chunk-size - int (default: 200)
-      chunk-size - int (default: 200)
-      diff - str 
-      max-msg-lines - int (default: 20)
-      max-recursion-depth - int (default: 3)
-      rec-chunk - bool (default: False)
+      config-index - Type: int (default: 0)
+      log - Type: str (default: None)
+      max_tokens - Type: int (default: None)
+      no-stream - Type: bool (default: False)
+      preprompt - Type: str (default: None)
+      prettify - Type: bool (default: False)
+      provider - Type: str (default: None)
+      renderer - Type: str (default: auto)
+      stream-prettify - Type: bool (default: True)
+      temperature - Type: float (default: 0.7)
+      top_p - Type: float (default: 1.0)
+      web-search - Type: bool (default: False)
+
+    Code mode options (-c/--code):
+      language - Type: str (default: python)
+
+    Git commit message options (-g/--gitcommsg):
+      analyses-chunk-size - Type: int (default: 200)
+      chunk-size - Type: int (default: 200)
+      diff - Type: str (default: None)
+      max-msg-lines - Type: int (default: 20)
+      max-recursion-depth - Type: int (default: 3)
+      rec-chunk - Type: bool (default: False)
 
   Example usage:
     ngpt --cli-config set language java        - Set default language to java for code generation
-    ngpt --cli-config set provider Gemini      - Set Gemini as your default provider
     ngpt --cli-config set temperature 0.9      - Set default temperature to 0.9
     ngpt --cli-config set no-stream true       - Disable streaming by default
     ngpt --cli-config set recursive-chunk true - Enable recursive chunking for git commit messages

{ngpt-3.12.1 → ngpt-4.0.0}/README.md

@@ -244,44 +244,21 @@ For more examples and detailed usage, visit the [CLI Usage Guide](https://nazdri
 ```console
 ❯ ngpt -h
 
-usage: ngpt [-h] [-v] [--config [CONFIG]] [--config-index CONFIG_INDEX] [--provider PROVIDER] [--remove] [--show-config]
-            [--all] [--list-models] [--list-renderers] [--cli-config [COMMAND ...]] [--role-config [ACTION ...]]
-            [--api-key API_KEY] [--base-url BASE_URL] [--model MODEL] [--web-search] [--pipe]
+usage: ngpt [-h] [-v] [--api-key API_KEY] [--base-url BASE_URL] [--model MODEL] [--web-search] [--pipe]
             [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
-            [--preprompt PREPROMPT | --role ROLE] [--no-stream | --prettify | --stream-prettify]
+            [--preprompt PREPROMPT | --role ROLE] [--config [CONFIG]] [--config-index CONFIG_INDEX]
+            [--provider PROVIDER] [--remove] [--show-config] [--all] [--list-models] [--list-renderers]
+            [--cli-config [COMMAND ...]] [--role-config [ACTION ...]] [--no-stream | --prettify | --stream-prettify]
             [--renderer {auto,rich,glow}] [--language LANGUAGE] [--rec-chunk] [--diff [FILE]] [--chunk-size CHUNK_SIZE]
             [--analyses-chunk-size ANALYSES_CHUNK_SIZE] [--max-msg-lines MAX_MSG_LINES]
-            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [--multiline] [-i | -s | -c | -t | -r | -g]
-            [prompt]
+            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [-i | -s | -c | -t | -r | -g]
 
 nGPT - Interact with AI language models via OpenAI-compatible APIs
 
-positional arguments::
-
-[PROMPT]                            The prompt to send
-
-options::
+Global Options::
 
 -h, --help                          show this help message and exit
 -v, --version                       Show version information and exit
-
-Configuration Options::
-
---config [CONFIG]                   Path to a custom config file or, if no value provided, enter interactive
-                                    configuration mode to create a new config
---config-index CONFIG_INDEX         Index of the configuration to use or edit (default: 0)
---provider PROVIDER                 Provider name to identify the configuration to use
---remove                            Remove the configuration at the specified index (requires --config and
-                                    --config-index or --provider)
---show-config                       Show the current configuration(s) and exit
---all                               Show details for all configurations (requires --show-config)
---list-models                       List all available models for the current configuration and exit
---list-renderers                    Show available markdown renderers for use with --prettify
---cli-config [COMMAND ...]          Manage CLI configuration (set, get, unset, list, help)
---role-config [ACTION ...]          Manage custom roles (help, create, show, edit, list, remove) [role_name]
-
-Global Options::
-
 --api-key API_KEY                   API key for the service
 --base-url BASE_URL                 Base URL for the API
 --model MODEL                       Model to use
@@ -301,6 +278,21 @@ Global Options::
 --renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify
                                     (auto, rich, or glow)
 
+Configuration Options::
+
+--config [CONFIG]                   Path to a custom config file or, if no value provided, enter interactive
+                                    configuration mode to create a new config
+--config-index CONFIG_INDEX         Index of the configuration to use or edit (default: 0)
+--provider PROVIDER                 Provider name to identify the configuration to use
+--remove                            Remove the configuration at the specified index (requires --config and
+                                    --config-index or --provider)
+--show-config                       Show the current configuration(s) and exit
+--all                               Show details for all configurations (requires --show-config)
+--list-models                       List all available models for the current configuration and exit
+--list-renderers                    Show available markdown renderers for use with --prettify
+--cli-config [COMMAND ...]          Manage CLI configuration (set, get, unset, list, help)
+--role-config [ACTION ...]          Manage custom roles (help, create, show, edit, list, remove) [role_name]
+
 Output Display Options (mutually exclusive)::
 
 --no-stream                         Return the whole response without streaming or formatting
@@ -328,10 +320,6 @@ Rewrite Mode Options::
 --humanize                          Transform AI-generated text into human-like content that passes AI detection
                                     tools
 
-Interactive Mode Options::
-
---multiline                         Enable multiline text input with the "ml" command in interactive mode
-
 Modes (mutually exclusive)::
 
 -i, --interactive                   Start an interactive chat session
@@ -418,37 +406,36 @@ CLI Configuration Help:
     ngpt --cli-config get OPTION          - Get the current value of OPTION
     ngpt --cli-config get                 - Show all CLI configuration settings
     ngpt --cli-config unset OPTION        - Remove OPTION from configuration
-    ngpt --cli-config list                - List all available options
+    ngpt --cli-config list                - List all available options with types and defaults
 
   Available options:
     General options (all modes):
-      config-index - int (default: 0) [exclusive with: provider]
-      log - str 
-      max_tokens - int 
-      no-stream - bool (default: False) [exclusive with: prettify, stream-prettify]
-      preprompt - str 
-      prettify - bool (default: False) [exclusive with: no-stream, stream-prettify]
-      provider - str  [exclusive with: config-index]
-      renderer - str (default: auto)
-      stream-prettify - bool (default: False) [exclusive with: no-stream, prettify]
-      temperature - float (default: 0.7)
-      top_p - float (default: 1.0)
-      web-search - bool (default: False)
-
-    Options for Code generation mode:
-      language - str (default: python)
-
-    Options for Git commit message mode:
-      analyses-chunk-size - int (default: 200)
-      chunk-size - int (default: 200)
-      diff - str 
-      max-msg-lines - int (default: 20)
-      max-recursion-depth - int (default: 3)
-      rec-chunk - bool (default: False)
+      config-index - Type: int (default: 0)
+      log - Type: str (default: None)
+      max_tokens - Type: int (default: None)
+      no-stream - Type: bool (default: False)
+      preprompt - Type: str (default: None)
+      prettify - Type: bool (default: False)
+      provider - Type: str (default: None)
+      renderer - Type: str (default: auto)
+      stream-prettify - Type: bool (default: True)
+      temperature - Type: float (default: 0.7)
+      top_p - Type: float (default: 1.0)
+      web-search - Type: bool (default: False)
+
+    Code mode options (-c/--code):
+      language - Type: str (default: python)
+
+    Git commit message options (-g/--gitcommsg):
+      analyses-chunk-size - Type: int (default: 200)
+      chunk-size - Type: int (default: 200)
+      diff - Type: str (default: None)
+      max-msg-lines - Type: int (default: 20)
+      max-recursion-depth - Type: int (default: 3)
+      rec-chunk - Type: bool (default: False)
 
   Example usage:
     ngpt --cli-config set language java        - Set default language to java for code generation
-    ngpt --cli-config set provider Gemini      - Set Gemini as your default provider
     ngpt --cli-config set temperature 0.9      - Set default temperature to 0.9
     ngpt --cli-config set no-stream true       - Disable streaming by default
     ngpt --cli-config set recursive-chunk true - Enable recursive chunking for git commit messages

{ngpt-3.12.1 → ngpt-4.0.0}/docs/configuration.md

@@ -146,46 +146,21 @@ You can set configuration options directly via command-line arguments:
 
 
 ```console
-❯ ngpt -h
-
-usage: ngpt [-h] [-v] [--config [CONFIG]] [--config-index CONFIG_INDEX] [--provider PROVIDER] [--remove] [--show-config]
-            [--all] [--list-models] [--list-renderers] [--cli-config [COMMAND ...]] [--role-config [ACTION ...]]
-            [--api-key API_KEY] [--base-url BASE_URL] [--model MODEL] [--web-search] [--pipe]
+usage: ngpt [-h] [-v] [--api-key API_KEY] [--base-url BASE_URL] [--model MODEL] [--web-search] [--pipe]
             [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
-            [--preprompt PREPROMPT | --role ROLE] [--no-stream | --prettify | --stream-prettify]
+            [--preprompt PREPROMPT | --role ROLE] [--config [CONFIG]] [--config-index CONFIG_INDEX]
+            [--provider PROVIDER] [--remove] [--show-config] [--all] [--list-models] [--list-renderers]
+            [--cli-config [COMMAND ...]] [--role-config [ACTION ...]] [--no-stream | --prettify | --stream-prettify]
             [--renderer {auto,rich,glow}] [--language LANGUAGE] [--rec-chunk] [--diff [FILE]] [--chunk-size CHUNK_SIZE]
             [--analyses-chunk-size ANALYSES_CHUNK_SIZE] [--max-msg-lines MAX_MSG_LINES]
-            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [--multiline] [-i | -s | -c | -t | -r | -g]
-            [prompt]
+            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [-i | -s | -c | -t | -r | -g]
 
 nGPT - Interact with AI language models via OpenAI-compatible APIs
 
-positional arguments::
-
-[PROMPT]                            The prompt to send
-
-options::
+Global Options::
 
 -h, --help                          show this help message and exit
 -v, --version                       Show version information and exit
-
-Configuration Options::
-
---config [CONFIG]                   Path to a custom config file or, if no value provided, enter interactive
-                                    configuration mode to create a new config
---config-index CONFIG_INDEX         Index of the configuration to use or edit (default: 0)
---provider PROVIDER                 Provider name to identify the configuration to use
---remove                            Remove the configuration at the specified index (requires --config and
-                                    --config-index or --provider)
---show-config                       Show the current configuration(s) and exit
---all                               Show details for all configurations (requires --show-config)
---list-models                       List all available models for the current configuration and exit
---list-renderers                    Show available markdown renderers for use with --prettify
---cli-config [COMMAND ...]          Manage CLI configuration (set, get, unset, list, help)
---role-config [ACTION ...]          Manage custom roles (help, create, show, edit, list, remove) [role_name]
-
-Global Options::
-
 --api-key API_KEY                   API key for the service
 --base-url BASE_URL                 Base URL for the API
 --model MODEL                       Model to use
@@ -205,6 +180,21 @@ Global Options::
 --renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify
                                     (auto, rich, or glow)
 
+Configuration Options::
+
+--config [CONFIG]                   Path to a custom config file or, if no value provided, enter interactive
+                                    configuration mode to create a new config
+--config-index CONFIG_INDEX         Index of the configuration to use or edit (default: 0)
+--provider PROVIDER                 Provider name to identify the configuration to use
+--remove                            Remove the configuration at the specified index (requires --config and
+                                    --config-index or --provider)
+--show-config                       Show the current configuration(s) and exit
+--all                               Show details for all configurations (requires --show-config)
+--list-models                       List all available models for the current configuration and exit
+--list-renderers                    Show available markdown renderers for use with --prettify
+--cli-config [COMMAND ...]          Manage CLI configuration (set, get, unset, list, help)
+--role-config [ACTION ...]          Manage custom roles (help, create, show, edit, list, remove) [role_name]
+
 Output Display Options (mutually exclusive)::
 
 --no-stream                         Return the whole response without streaming or formatting
@@ -232,10 +222,6 @@ Rewrite Mode Options::
 --humanize                          Transform AI-generated text into human-like content that passes AI detection
                                     tools
 
-Interactive Mode Options::
-
---multiline                         Enable multiline text input with the "ml" command in interactive mode
-
 Modes (mutually exclusive)::
 
 -i, --interactive                   Start an interactive chat session

{ngpt-3.12.1 → ngpt-4.0.0}/docs/usage/cli_config.md

@@ -171,6 +171,12 @@ The CLI configuration system enforces these rules to prevent incompatible combin
 |--------|------|---------|-------------|
 | `language` | string | python | Programming language for code generation |
 
+#### Interactive Mode
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `interactive-multiline` | bool | false | Enable multiline text input with the "ml" command in interactive mode |
+
 #### Git Commit Message Mode
 
 | Option | Type | Default | Description |
@@ -197,6 +203,16 @@ ngpt --cli-config set prettify true
 ngpt --cli-config set temperature 0.3
 ```
 
+### Setting Up for Interactive Chat
+
+```bash
+# Enable multiline input in interactive mode by default
+ngpt --cli-config set interactive-multiline true
+
+# Set a custom system prompt for interactive sessions
+ngpt --cli-config set preprompt "You are a helpful coding assistant specializing in Python"
+```
+
 ### Setting Up a Creative Writing Environment
 
 ```bash

{ngpt-3.12.1 → ngpt-4.0.0}/docs/usage/cli_usage.md

@@ -39,44 +39,21 @@ You can set configuration options directly via command-line arguments:
 ```console
 ❯ ngpt -h
 
-usage: ngpt [-h] [-v] [--config [CONFIG]] [--config-index CONFIG_INDEX] [--provider PROVIDER] [--remove] [--show-config]
-            [--all] [--list-models] [--list-renderers] [--cli-config [COMMAND ...]] [--role-config [ACTION ...]]
-            [--api-key API_KEY] [--base-url BASE_URL] [--model MODEL] [--web-search] [--pipe]
+usage: ngpt [-h] [-v] [--api-key API_KEY] [--base-url BASE_URL] [--model MODEL] [--web-search] [--pipe]
             [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
-            [--preprompt PREPROMPT | --role ROLE] [--no-stream | --prettify | --stream-prettify]
+            [--preprompt PREPROMPT | --role ROLE] [--config [CONFIG]] [--config-index CONFIG_INDEX]
+            [--provider PROVIDER] [--remove] [--show-config] [--all] [--list-models] [--list-renderers]
+            [--cli-config [COMMAND ...]] [--role-config [ACTION ...]] [--no-stream | --prettify | --stream-prettify]
             [--renderer {auto,rich,glow}] [--language LANGUAGE] [--rec-chunk] [--diff [FILE]] [--chunk-size CHUNK_SIZE]
             [--analyses-chunk-size ANALYSES_CHUNK_SIZE] [--max-msg-lines MAX_MSG_LINES]
-            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [--multiline] [-i | -s | -c | -t | -r | -g]
-            [prompt]
+            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [-i | -s | -c | -t | -r | -g]
 
 nGPT - Interact with AI language models via OpenAI-compatible APIs
 
-positional arguments::
-
-[PROMPT]                            The prompt to send
-
-options::
+Global Options::
 
 -h, --help                          show this help message and exit
 -v, --version                       Show version information and exit
-
-Configuration Options::
-
---config [CONFIG]                   Path to a custom config file or, if no value provided, enter interactive
-                                    configuration mode to create a new config
---config-index CONFIG_INDEX         Index of the configuration to use or edit (default: 0)
---provider PROVIDER                 Provider name to identify the configuration to use
---remove                            Remove the configuration at the specified index (requires --config and
-                                    --config-index or --provider)
---show-config                       Show the current configuration(s) and exit
---all                               Show details for all configurations (requires --show-config)
---list-models                       List all available models for the current configuration and exit
---list-renderers                    Show available markdown renderers for use with --prettify
---cli-config [COMMAND ...]          Manage CLI configuration (set, get, unset, list, help)
---role-config [ACTION ...]          Manage custom roles (help, create, show, edit, list, remove) [role_name]
-
-Global Options::
-
 --api-key API_KEY                   API key for the service
 --base-url BASE_URL                 Base URL for the API
 --model MODEL                       Model to use
@@ -96,6 +73,21 @@ Global Options::
 --renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify
                                     (auto, rich, or glow)
 
+Configuration Options::
+
+--config [CONFIG]                   Path to a custom config file or, if no value provided, enter interactive
+                                    configuration mode to create a new config
+--config-index CONFIG_INDEX         Index of the configuration to use or edit (default: 0)
+--provider PROVIDER                 Provider name to identify the configuration to use
+--remove                            Remove the configuration at the specified index (requires --config and
+                                    --config-index or --provider)
+--show-config                       Show the current configuration(s) and exit
+--all                               Show details for all configurations (requires --show-config)
+--list-models                       List all available models for the current configuration and exit
+--list-renderers                    Show available markdown renderers for use with --prettify
+--cli-config [COMMAND ...]          Manage CLI configuration (set, get, unset, list, help)
+--role-config [ACTION ...]          Manage custom roles (help, create, show, edit, list, remove) [role_name]
+
 Output Display Options (mutually exclusive)::
 
 --no-stream                         Return the whole response without streaming or formatting
@@ -123,10 +115,6 @@ Rewrite Mode Options::
 --humanize                          Transform AI-generated text into human-like content that passes AI detection
                                     tools
 
-Interactive Mode Options::
-
---multiline                         Enable multiline text input with the "ml" command in interactive mode
-
 Modes (mutually exclusive)::
 
 -i, --interactive                   Start an interactive chat session
@@ -195,6 +183,40 @@ ngpt --code --log "function to calculate prime numbers"
 ngpt --shell --log "find large files in current directory"
 ```
 
+#### Multiline Text Input in Interactive Mode
+
+Enable multiline input in interactive chat mode:
+
+```bash
+ngpt -i
+```
+
+In interective mode you can:
+- Use the "ml" command to enter multiline text mode
+- Type or paste complex, multi-paragraph prompts
+- Press Ctrl+D (or Ctrl+Z on Windows) to submit the multiline input
+- Exit multiline mode anytime by typing ".exit" on a new line
+
+This is especially useful when:
+- Providing code samples for the AI to analyze
+- Entering complex contexts or scenarios
+- Pasting error logs or output for debugging help
+- Composing detailed questions with multiple parts
+
+Example usage:
+```
+> ml
+(multiline mode - press Ctrl+D to submit)
+Here's the error I'm getting:
+
+TypeError: cannot convert 'NoneType' object to int
+  File "app.py", line 45, in process_data
+    result = data['count'] + 5
+
+Can you help me understand what's wrong?
+^D
+```
+
 #### Combining with Other Options
 
 Interactive mode can be combined with other options for enhanced functionality:

{ngpt-3.12.1 → ngpt-4.0.0}/ngpt/cli/args.py

@@ -12,7 +12,8 @@ def setup_argument_parser():
     # Minimalist, clean epilog design
     epilog = f"\n{COLORS['yellow']}nGPT {COLORS['bold']}v{__version__}{COLORS['reset']}  •  {COLORS['green']}Docs: {COLORS['bold']}https://nazdridoy.github.io/ngpt/usage/cli_usage{COLORS['reset']}"
     
-    parser = argparse.ArgumentParser(description=description, formatter_class=ColoredHelpFormatter, epilog=epilog)
+    parser = argparse.ArgumentParser(description=description, formatter_class=ColoredHelpFormatter, 
+                                    epilog=epilog, add_help=False)
     
     # Add custom error method with color
     original_error = parser.error
@@ -27,41 +28,16 @@ def setup_argument_parser():
             print(f"{COLORS['green']}{COLORS['bold']}nGPT{COLORS['reset']} version {COLORS['yellow']}{__version__}{COLORS['reset']}")
             parser.exit()
     
-    # Version flag
-    parser.add_argument('-v', '--version', action=ColoredVersionAction, nargs=0, 
-                        help='Show version information and exit')
-    
-    # Prompt argument
-    parser.add_argument('prompt', nargs='?', default=None, 
-                        help='The prompt to send')
-
-    # Config options
-    config_group = parser.add_argument_group('Configuration Options')
-    config_group.add_argument('--config', nargs='?', const=True, 
-                              help='Path to a custom config file or, if no value provided, enter interactive configuration mode to create a new config')
-    config_group.add_argument('--config-index', type=int, default=0, 
-                              help='Index of the configuration to use or edit (default: 0)')
-    config_group.add_argument('--provider', 
-                              help='Provider name to identify the configuration to use')
-    config_group.add_argument('--remove', action='store_true', 
-                              help='Remove the configuration at the specified index (requires --config and --config-index or --provider)')
-    config_group.add_argument('--show-config', action='store_true', 
-                              help='Show the current configuration(s) and exit')
-    config_group.add_argument('--all', action='store_true', 
-                              help='Show details for all configurations (requires --show-config)')
-    config_group.add_argument('--list-models', action='store_true', 
-                              help='List all available models for the current configuration and exit')
-    config_group.add_argument('--list-renderers', action='store_true', 
-                              help='Show available markdown renderers for use with --prettify')
-    config_group.add_argument('--cli-config', nargs='*', metavar='COMMAND', 
-                              help='Manage CLI configuration (set, get, unset, list, help)')
-    
-    # Role configuration options
-    config_group.add_argument('--role-config', nargs='*', metavar='ACTION', 
-                              help='Manage custom roles (help, create, show, edit, list, remove) [role_name]')
-
     # Global options
     global_group = parser.add_argument_group('Global Options')
+    
+    # Add help and version to the global group
+    global_group.add_argument('-h', '--help', action='help',
+                             help='show this help message and exit')
+    global_group.add_argument('-v', '--version', action=ColoredVersionAction, nargs=0, 
+                             help='Show version information and exit')
+    
+    # Then add the other global options
     global_group.add_argument('--api-key', 
                               help='API key for the service')
     global_group.add_argument('--base-url', 
@@ -88,6 +64,29 @@ def setup_argument_parser():
     prompt_exclusive_group.add_argument('--role', 
                       help='Use a predefined role to set system prompt (mutually exclusive with --preprompt)')
     
+    # Config options
+    config_group = parser.add_argument_group('Configuration Options')
+    config_group.add_argument('--config', nargs='?', const=True, 
+                              help='Path to a custom config file or, if no value provided, enter interactive configuration mode to create a new config')
+    config_group.add_argument('--config-index', type=int, default=0, 
+                              help='Index of the configuration to use or edit (default: 0)')
+    config_group.add_argument('--provider', 
+                              help='Provider name to identify the configuration to use')
+    config_group.add_argument('--remove', action='store_true', 
+                              help='Remove the configuration at the specified index (requires --config and --config-index or --provider)')
+    config_group.add_argument('--show-config', action='store_true', 
+                              help='Show the current configuration(s) and exit')
+    config_group.add_argument('--all', action='store_true', 
+                              help='Show details for all configurations (requires --show-config)')
+    config_group.add_argument('--list-models', action='store_true', 
+                              help='List all available models for the current configuration and exit')
+    config_group.add_argument('--list-renderers', action='store_true', 
+                              help='Show available markdown renderers for use with --prettify')
+    config_group.add_argument('--cli-config', nargs='*', metavar='COMMAND', 
+                              help='Manage CLI configuration (set, get, unset, list, help)')
+    config_group.add_argument('--role-config', nargs='*', metavar='ACTION', 
+                              help='Manage custom roles (help, create, show, edit, list, remove) [role_name]')
+
     # Output display options (mutually exclusive group)
     output_group = parser.add_argument_group('Output Display Options (mutually exclusive)')
     output_exclusive_group = output_group.add_mutually_exclusive_group()
@@ -128,8 +127,6 @@ def setup_argument_parser():
     
     # Interactive mode options
     interactive_group = parser.add_argument_group('Interactive Mode Options')
-    interactive_group.add_argument('--multiline', action='store_true',
-                              help='Enable multiline text input with the "ml" command in interactive mode')
     
     # Mode flags (mutually exclusive)
     mode_group = parser.add_argument_group('Modes (mutually exclusive)')

{ngpt-3.12.1 → ngpt-4.0.0}/ngpt/cli/main.py

@@ -37,7 +37,7 @@ def show_cli_config_help():
     print(f"    {COLORS['yellow']}ngpt --cli-config get OPTION{COLORS['reset']}          - Get the current value of OPTION")
     print(f"    {COLORS['yellow']}ngpt --cli-config get{COLORS['reset']}                 - Show all CLI configuration settings")
     print(f"    {COLORS['yellow']}ngpt --cli-config unset OPTION{COLORS['reset']}        - Remove OPTION from configuration")
-    print(f"    {COLORS['yellow']}ngpt --cli-config list{COLORS['reset']}                - List all available options")
+    print(f"    {COLORS['yellow']}ngpt --cli-config list{COLORS['reset']}                - List all available options with types and defaults")
     
     print(f"\n  {COLORS['cyan']}Available options:{COLORS['reset']}")
     
@@ -51,8 +51,10 @@ def show_cli_config_help():
         "gitcommsg": []  # Add gitcommsg context
     }
     
-    for option, meta in CLI_CONFIG_OPTIONS.items():
-        for context in meta["context"]:
+    # Get option details from list_cli_config_options instead of CLI_CONFIG_OPTIONS
+    for option_details in list_cli_config_options():
+        option = option_details["name"]
+        for context in option_details["context"]:
             if context in context_groups:
                 if context == "all":
                     context_groups[context].append(option)
@@ -63,25 +65,57 @@ def show_cli_config_help():
     # Print general options (available in all contexts)
     print(f"    {COLORS['yellow']}General options (all modes):{COLORS['reset']}")
     for option in sorted(context_groups["all"]):
-        print(f"      {option}")
+        # Get option details
+        option_detail = next((o for o in list_cli_config_options() if o["name"] == option), None)
+        if option_detail:
+            option_type = option_detail["type"]
+            default = option_detail["default"]
+            default_str = f"(default: {default})" if default is not None else "(default: None)"
+            print(f"      {option} - {COLORS['cyan']}Type: {option_type}{COLORS['reset']} {default_str}")
+        else:
+            print(f"      {option}")
     
     # Print code options
     if context_groups["code"]:
         print(f"\n    {COLORS['yellow']}Code mode options (-c/--code):{COLORS['reset']}")
         for option in sorted(context_groups["code"]):
-            print(f"      {option}")
+            # Get option details
+            option_detail = next((o for o in list_cli_config_options() if o["name"] == option), None)
+            if option_detail:
+                option_type = option_detail["type"]
+                default = option_detail["default"]
+                default_str = f"(default: {default})" if default is not None else "(default: None)"
+                print(f"      {option} - {COLORS['cyan']}Type: {option_type}{COLORS['reset']} {default_str}")
+            else:
+                print(f"      {option}")
     
     # Print interactive mode options
     if context_groups["interactive"]:
         print(f"\n    {COLORS['yellow']}Interactive mode options (-i/--interactive):{COLORS['reset']}")
         for option in sorted(context_groups["interactive"]):
-            print(f"      {option}")
+            # Get option details
+            option_detail = next((o for o in list_cli_config_options() if o["name"] == option), None)
+            if option_detail:
+                option_type = option_detail["type"]
+                default = option_detail["default"]
+                default_str = f"(default: {default})" if default is not None else "(default: None)"
+                print(f"      {option} - {COLORS['cyan']}Type: {option_type}{COLORS['reset']} {default_str}")
+            else:
+                print(f"      {option}")
     
     # Print gitcommsg options
     if context_groups["gitcommsg"]:
         print(f"\n    {COLORS['yellow']}Git commit message options (-g/--gitcommsg):{COLORS['reset']}")
         for option in sorted(context_groups["gitcommsg"]):
-            print(f"      {option}")
+            # Get option details
+            option_detail = next((o for o in list_cli_config_options() if o["name"] == option), None)
+            if option_detail:
+                option_type = option_detail["type"]
+                default = option_detail["default"]
+                default_str = f"(default: {default})" if default is not None else "(default: None)"
+                print(f"      {option} - {COLORS['cyan']}Type: {option_type}{COLORS['reset']} {default_str}")
+            else:
+                print(f"      {option}")
     
     print(f"\n  {COLORS['cyan']}Example usage:{COLORS['reset']}")
     print(f"    {COLORS['yellow']}ngpt --cli-config set language java{COLORS['reset']}        - Set default language to java for code generation")
@@ -111,13 +145,18 @@ def handle_cli_config(action, option=None, value=None):
     if action == "list":
         # List all available options
         print(f"{COLORS['green']}{COLORS['bold']}Available CLI configuration options:{COLORS['reset']}")
-        for option in list_cli_config_options():
-            meta = CLI_CONFIG_OPTIONS[option]
-            default = f"(default: {meta['default']})" if meta['default'] is not None else ""
-            contexts = ', '.join(meta['context'])
-            if "all" in meta['context']:
-                contexts = "all modes"
-            print(f"  {COLORS['cyan']}{option}{COLORS['reset']} - {meta['type']} {default} - Available in: {contexts}")
+        for option_details in list_cli_config_options():
+            option = option_details["name"]
+            option_type = option_details["type"]
+            default = option_details["default"]
+            contexts = option_details["context"]
+            
+            default_str = f"(default: {default})" if default is not None else "(default: None)"
+            contexts_str = ', '.join(contexts)
+            if "all" in contexts:
+                contexts_str = "all modes"
+            
+            print(f"  {COLORS['cyan']}{option}{COLORS['reset']} - {COLORS['yellow']}Type: {option_type}{COLORS['reset']} {default_str} - Available in: {contexts_str}")
         return
     
     if action == "get":
@@ -539,8 +578,7 @@ def main():
                 prettify=args.prettify,
                 renderer=args.renderer,
                 stream_prettify=args.stream_prettify,
-                logger=logger,
-                multiline_enabled=args.multiline
+                logger=logger
             )
         elif args.shell:
             # Apply CLI config for shell mode

{ngpt-3.12.1 → ngpt-4.0.0}/ngpt/cli/modes/interactive.py

@@ -20,7 +20,7 @@ try:
 except ImportError:
     HAS_PROMPT_TOOLKIT = False
 
-def interactive_chat_session(client, web_search=False, no_stream=False, temperature=0.7, top_p=1.0, max_tokens=None, preprompt=None, prettify=False, renderer='auto', stream_prettify=False, logger=None, multiline_enabled=False):
+def interactive_chat_session(client, web_search=False, no_stream=False, temperature=0.7, top_p=1.0, max_tokens=None, preprompt=None, prettify=False, renderer='auto', stream_prettify=False, logger=None, multiline_enabled=True):
     """Start an interactive chat session with the AI.
     
     Args:

{ngpt-3.12.1 → ngpt-4.0.0}/ngpt/utils/cli_config.py

@@ -19,8 +19,6 @@ CLI_CONFIG_OPTIONS = {
     "renderer": {"type": "str", "default": "auto", "context": ["all"]},
     "config-index": {"type": "int", "default": 0, "context": ["all"], "exclusive": ["provider"]},
     "web-search": {"type": "bool", "default": False, "context": ["all"]},
-    # Interactive mode options
-    "interactive-multiline": {"type": "bool", "default": False, "context": ["interactive"]},
     # GitCommit message options
     "rec-chunk": {"type": "bool", "default": False, "context": ["gitcommsg"]},
     "diff": {"type": "str", "default": None, "context": ["gitcommsg"]},
@@ -245,10 +243,6 @@ def apply_cli_config(args: Any, mode: str) -> Any:
         # Convert dashes to underscores for argparse compatibility
         arg_name = option.replace("-", "_")
         
-        # Special case for interactive-multiline which maps to multiline argument
-        if option == "interactive-multiline":
-            arg_name = "multiline"
-        
         # Skip if explicitly set via command line
         cli_option = f"--{option}"
         if cli_option in explicit_args:
@@ -288,6 +282,19 @@ def apply_cli_config(args: Any, mode: str) -> Any:
     
     return args
 
-def list_cli_config_options() -> List[str]:
-    """List all available CLI configuration options."""
-    return sorted(CLI_CONFIG_OPTIONS.keys()) 
+def list_cli_config_options() -> List[Dict[str, Any]]:
+    """List all available CLI configuration options with their types and default values.
+    
+    Returns:
+        List of dictionaries containing option details
+    """
+    options_list = []
+    for option, details in sorted(CLI_CONFIG_OPTIONS.items()):
+        options_list.append({
+            "name": option,
+            "type": details["type"],
+            "default": details["default"],
+            "context": details["context"],
+            "exclusive": details.get("exclusive", [])
+        })
+    return options_list 

{ngpt-3.12.1 → ngpt-4.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ngpt"
-version = "3.12.1"
+version = "4.0.0"
 description = "A Swiss army knife for LLMs: A fast, lightweight CLI and interactive chat tool that brings the power of any OpenAI-compatible LLM (OpenAI, Ollama, Groq, Claude, Gemini, etc.) straight to your terminal. rewrite texts or refine code, craft git commit messages, generate and run OS-aware shell commands."
 authors = [
     {name = "nazDridoy", email = "nazdridoy399@gmail.com"},

{ngpt-3.12.1 → ngpt-4.0.0}/uv.lock

@@ -148,7 +148,7 @@ wheels = [
 
 [[package]]
 name = "ngpt"
-version = "3.12.1"
+version = "4.0.0"
 source = { editable = "." }
 dependencies = [
     { name = "beautifulsoup4" },