ngpt 3.12.0__tar.gz → 3.12.2__tar.gz

{ngpt-3.12.0 → ngpt-3.12.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ngpt
-Version: 3.12.0
+Version: 3.12.2
 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,14 +281,14 @@ For more examples and detailed usage, visit the [CLI Usage Guide](https://nazdri
 ```console
 ❯ ngpt -h
 
-usage: ngpt [-h] [-v] [--language LANGUAGE] [--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] [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
+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]
+            [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
             [--preprompt PREPROMPT | --role ROLE] [--no-stream | --prettify | --stream-prettify]
-            [--renderer {auto,rich,glow}] [--rec-chunk] [--diff [FILE]] [--chunk-size CHUNK_SIZE]
+            [--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] [-i | -s | -c | -t | -r | -g] [--humanize]
+            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [--multiline] [-i | -s | -c | -t | -r | -g]
             [prompt]
 
 nGPT - Interact with AI language models via OpenAI-compatible APIs
@@ -301,14 +301,15 @@ options::
 
 -h, --help                          show this help message and exit
 -v, --version                       Show version information and exit
---language LANGUAGE                 Programming language to generate code in (for code mode)
 
 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 [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)
+--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
@@ -321,15 +322,21 @@ 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
---web-search                        Enable web search capability using DuckDuckGo to enhance prompts with relevant information
---pipe                              Read from stdin and use content with prompt. Use {} in prompt as placeholder for stdin content. Can be used with any mode option except --text and --interactive
+--web-search                        Enable web search capability using DuckDuckGo to enhance prompts with relevant
+                                    information
+--pipe                              Read from stdin and use content with prompt. Use {} in prompt as placeholder
+                                    for stdin content. Can be used with any mode option except --text and
+                                    --interactive
 --temperature TEMPERATURE           Set temperature (controls randomness, default: 0.7)
 --top_p TOP_P                       Set top_p (controls diversity, default: 1.0)
 --max_tokens MAX_TOKENS             Set max response length in tokens
---log [FILE]                        Set filepath to log conversation to, or create a temporary log file if no path provided
+--log [FILE]                        Set filepath to log conversation to, or create a temporary log file if no path
+                                    provided
 --preprompt PREPROMPT               Set custom system prompt to control AI behavior
---role ROLE                         Use a predefined role to set system prompt (mutually exclusive with --preprompt)
---renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify (auto, rich, or glow)
+--role ROLE                         Use a predefined role to set system prompt (mutually exclusive with
+                                    --preprompt)
+--renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify
+                                    (auto, rich, or glow)
 
 Output Display Options (mutually exclusive)::
 
@@ -337,14 +344,30 @@ Output Display Options (mutually exclusive)::
 --prettify                          Render complete response with markdown and code formatting (non-streaming)
 --stream-prettify                   Stream response with real-time markdown rendering (default)
 
+Code Mode Options::
+
+--language LANGUAGE                 Programming language to generate code in (for code mode)
+
 Git Commit Message Options::
 
 --rec-chunk                         Process large diffs in chunks with recursive analysis if needed
---diff [FILE]                       Use diff from specified file instead of staged changes. If used without a path, uses the path from CLI config.
+--diff [FILE]                       Use diff from specified file instead of staged changes. If used without a path,
+                                    uses the path from CLI config.
 --chunk-size CHUNK_SIZE             Number of lines per chunk when chunking is enabled (default: 200)
---analyses-chunk-size ANALYSES_CHUNK_SIZE Number of lines per chunk when recursively chunking analyses (default: 200)
+--analyses-chunk-size ANALYSES_CHUNK_SIZE
+                                    Number of lines per chunk when recursively chunking analyses (default: 200)
 --max-msg-lines MAX_MSG_LINES       Maximum number of lines in commit message before condensing (default: 20)
---max-recursion-depth MAX_RECURSION_DEPTH Maximum recursion depth for commit message condensing (default: 3)
+--max-recursion-depth MAX_RECURSION_DEPTH
+                                    Maximum recursion depth for commit message condensing (default: 3)
+
+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)::
 
@@ -355,10 +378,6 @@ Modes (mutually exclusive)::
 -r, --rewrite                       Rewrite text from stdin to be more natural while preserving tone and meaning
 -g, --gitcommsg                     Generate AI-powered git commit messages from staged changes or diff file
 
-Rewrite Mode Options::
-
---humanize                          Transform AI-generated text into human-like content that passes AI detection tools
-
 ```
 
 > **Note**: For better visualization of conventional commit messages on GitHub, you can use the [GitHub Commit Labels](https://greasyfork.org/en/scripts/526153-github-commit-labels) userscript, which adds colorful labels to your commits.
@@ -436,37 +455,39 @@ 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)
+
+    Interactive mode options (-i/--interactive):
+      interactive-multiline - Type: bool (default: False)
+
+    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.0 → ngpt-3.12.2}/README.md

@@ -244,14 +244,14 @@ For more examples and detailed usage, visit the [CLI Usage Guide](https://nazdri
 ```console
 ❯ ngpt -h
 
-usage: ngpt [-h] [-v] [--language LANGUAGE] [--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] [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
+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]
+            [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
             [--preprompt PREPROMPT | --role ROLE] [--no-stream | --prettify | --stream-prettify]
-            [--renderer {auto,rich,glow}] [--rec-chunk] [--diff [FILE]] [--chunk-size CHUNK_SIZE]
+            [--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] [-i | -s | -c | -t | -r | -g] [--humanize]
+            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [--multiline] [-i | -s | -c | -t | -r | -g]
             [prompt]
 
 nGPT - Interact with AI language models via OpenAI-compatible APIs
@@ -264,14 +264,15 @@ options::
 
 -h, --help                          show this help message and exit
 -v, --version                       Show version information and exit
---language LANGUAGE                 Programming language to generate code in (for code mode)
 
 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 [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)
+--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
@@ -284,15 +285,21 @@ 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
---web-search                        Enable web search capability using DuckDuckGo to enhance prompts with relevant information
---pipe                              Read from stdin and use content with prompt. Use {} in prompt as placeholder for stdin content. Can be used with any mode option except --text and --interactive
+--web-search                        Enable web search capability using DuckDuckGo to enhance prompts with relevant
+                                    information
+--pipe                              Read from stdin and use content with prompt. Use {} in prompt as placeholder
+                                    for stdin content. Can be used with any mode option except --text and
+                                    --interactive
 --temperature TEMPERATURE           Set temperature (controls randomness, default: 0.7)
 --top_p TOP_P                       Set top_p (controls diversity, default: 1.0)
 --max_tokens MAX_TOKENS             Set max response length in tokens
---log [FILE]                        Set filepath to log conversation to, or create a temporary log file if no path provided
+--log [FILE]                        Set filepath to log conversation to, or create a temporary log file if no path
+                                    provided
 --preprompt PREPROMPT               Set custom system prompt to control AI behavior
---role ROLE                         Use a predefined role to set system prompt (mutually exclusive with --preprompt)
---renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify (auto, rich, or glow)
+--role ROLE                         Use a predefined role to set system prompt (mutually exclusive with
+                                    --preprompt)
+--renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify
+                                    (auto, rich, or glow)
 
 Output Display Options (mutually exclusive)::
 
@@ -300,14 +307,30 @@ Output Display Options (mutually exclusive)::
 --prettify                          Render complete response with markdown and code formatting (non-streaming)
 --stream-prettify                   Stream response with real-time markdown rendering (default)
 
+Code Mode Options::
+
+--language LANGUAGE                 Programming language to generate code in (for code mode)
+
 Git Commit Message Options::
 
 --rec-chunk                         Process large diffs in chunks with recursive analysis if needed
---diff [FILE]                       Use diff from specified file instead of staged changes. If used without a path, uses the path from CLI config.
+--diff [FILE]                       Use diff from specified file instead of staged changes. If used without a path,
+                                    uses the path from CLI config.
 --chunk-size CHUNK_SIZE             Number of lines per chunk when chunking is enabled (default: 200)
---analyses-chunk-size ANALYSES_CHUNK_SIZE Number of lines per chunk when recursively chunking analyses (default: 200)
+--analyses-chunk-size ANALYSES_CHUNK_SIZE
+                                    Number of lines per chunk when recursively chunking analyses (default: 200)
 --max-msg-lines MAX_MSG_LINES       Maximum number of lines in commit message before condensing (default: 20)
---max-recursion-depth MAX_RECURSION_DEPTH Maximum recursion depth for commit message condensing (default: 3)
+--max-recursion-depth MAX_RECURSION_DEPTH
+                                    Maximum recursion depth for commit message condensing (default: 3)
+
+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)::
 
@@ -318,10 +341,6 @@ Modes (mutually exclusive)::
 -r, --rewrite                       Rewrite text from stdin to be more natural while preserving tone and meaning
 -g, --gitcommsg                     Generate AI-powered git commit messages from staged changes or diff file
 
-Rewrite Mode Options::
-
---humanize                          Transform AI-generated text into human-like content that passes AI detection tools
-
 ```
 
 > **Note**: For better visualization of conventional commit messages on GitHub, you can use the [GitHub Commit Labels](https://greasyfork.org/en/scripts/526153-github-commit-labels) userscript, which adds colorful labels to your commits.
@@ -399,37 +418,39 @@ 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)
+
+    Interactive mode options (-i/--interactive):
+      interactive-multiline - Type: bool (default: False)
+
+    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.0 → ngpt-3.12.2}/docs/configuration.md

@@ -144,85 +144,108 @@ The interactive configuration will prompt you for values and guide you through t
 
 You can set configuration options directly via command-line arguments:
 
-```
-usage: ngpt [-h] [-v] [--language LANGUAGE] [--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] [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
+
+```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]
+            [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
             [--preprompt PREPROMPT | --role ROLE] [--no-stream | --prettify | --stream-prettify]
-            [--renderer {auto,rich,glow}] [--rec-chunk] [--diff [FILE]] [--chunk-size CHUNK_SIZE]
+            [--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] [-i | -s | -c | -t | -r | -g] [--humanize]
+            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [--multiline] [-i | -s | -c | -t | -r | -g]
             [prompt]
 
 nGPT - Interact with AI language models via OpenAI-compatible APIs
-```
 
-### Positional Arguments
+positional arguments::
+
+[PROMPT]                            The prompt to send
 
-- `[PROMPT]`: The prompt to send
+options::
 
-### General Options
+-h, --help                          show this help message and exit
+-v, --version                       Show version information and exit
 
-- `-h, --help`: Show help message and exit
-- `-v, --version`: Show version information and exit
-- `--language <LANGUAGE>`: Programming language to generate code in (for code mode)
+Configuration Options::
 
-### 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]
 
-- `--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::
 
-### 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
+--web-search                        Enable web search capability using DuckDuckGo to enhance prompts with relevant
+                                    information
+--pipe                              Read from stdin and use content with prompt. Use {} in prompt as placeholder
+                                    for stdin content. Can be used with any mode option except --text and
+                                    --interactive
+--temperature TEMPERATURE           Set temperature (controls randomness, default: 0.7)
+--top_p TOP_P                       Set top_p (controls diversity, default: 1.0)
+--max_tokens MAX_TOKENS             Set max response length in tokens
+--log [FILE]                        Set filepath to log conversation to, or create a temporary log file if no path
+                                    provided
+--preprompt PREPROMPT               Set custom system prompt to control AI behavior
+--role ROLE                         Use a predefined role to set system prompt (mutually exclusive with
+                                    --preprompt)
+--renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify
+                                    (auto, rich, or glow)
 
-- `--api-key <API_KEY>`: API key for the service
-- `--base-url <BASE_URL>`: Base URL for the API
-- `--model <MODEL>`: Model to use
-- `--web-search`: Enable web search capability using DuckDuckGo to enhance prompts with relevant information
-- `--pipe`: Read from stdin and use content with prompt. Use {} in prompt as placeholder for stdin content. Can be used with any mode option except --text and --interactive
-- `--temperature <TEMPERATURE>`: Set temperature (controls randomness, default: 0.7)
-- `--top_p <TOP_P>`: Set top_p (controls diversity, default: 1.0)
-- `--max_tokens <MAX_TOKENS>`: Set max response length in tokens
-- `--log <[FILE]>`: Set filepath to log conversation to, or create a temporary log file if no path provided
-- `--preprompt <PREPROMPT>`: Set custom system prompt to control AI behavior
-- `--role <ROLE>`: Use a predefined role to set system prompt (mutually exclusive with --preprompt)
-- `--renderer <{auto,rich,glow}>`: Select which markdown renderer to use with --prettify or --stream-prettify (auto, rich, or glow)
+Output Display Options (mutually exclusive)::
 
-### Output Display Options (mutually exclusive)
+--no-stream                         Return the whole response without streaming or formatting
+--prettify                          Render complete response with markdown and code formatting (non-streaming)
+--stream-prettify                   Stream response with real-time markdown rendering (default)
 
-- `--no-stream`: Return the whole response without streaming or formatting
-- `--prettify`: Render complete response with markdown and code formatting (non-streaming)
-- `--stream-prettify`: Stream response with real-time markdown rendering (default)
+Code Mode Options::
 
-### Git Commit Message Options
+--language LANGUAGE                 Programming language to generate code in (for code mode)
 
-- `--rec-chunk`: Process large diffs in chunks with recursive analysis if needed
-- `--diff <[FILE]>`: Use diff from specified file instead of staged changes. If used without a path, uses the path from CLI config.
-- `--chunk-size <CHUNK_SIZE>`: Number of lines per chunk when chunking is enabled (default: 200)
-- `--analyses-chunk-size <ANALYSES_CHUNK_SIZE>`: Number of lines per chunk when recursively chunking analyses (default: 200)
-- `--max-msg-lines <MAX_MSG_LINES>`: Maximum number of lines in commit message before condensing (default: 20)
-- `--max-recursion-depth <MAX_RECURSION_DEPTH>`: Maximum recursion depth for commit message condensing (default: 3)
+Git Commit Message Options::
 
-### Modes (mutually exclusive)
+--rec-chunk                         Process large diffs in chunks with recursive analysis if needed
+--diff [FILE]                       Use diff from specified file instead of staged changes. If used without a path,
+                                    uses the path from CLI config.
+--chunk-size CHUNK_SIZE             Number of lines per chunk when chunking is enabled (default: 200)
+--analyses-chunk-size ANALYSES_CHUNK_SIZE
+                                    Number of lines per chunk when recursively chunking analyses (default: 200)
+--max-msg-lines MAX_MSG_LINES       Maximum number of lines in commit message before condensing (default: 20)
+--max-recursion-depth MAX_RECURSION_DEPTH
+                                    Maximum recursion depth for commit message condensing (default: 3)
 
-- `-i, --interactive`: Start an interactive chat session
-- `-s, --shell`: Generate and execute shell commands
-- `-c, --code`: Generate code
-- `-t, --text`: Enter multi-line text input (submit with Ctrl+D)
-- `-r, --rewrite`: Rewrite text from stdin to be more natural while preserving tone and meaning
-- `-g, --gitcommsg`: Generate AI-powered git commit messages from staged changes or diff file
+Rewrite Mode Options::
 
-### Rewrite Mode Options
+--humanize                          Transform AI-generated text into human-like content that passes AI detection
+                                    tools
 
-- `--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
+-s, --shell                         Generate and execute shell commands
+-c, --code                          Generate code
+-t, --text                          Enter multi-line text input (submit with Ctrl+D)
+-r, --rewrite                       Rewrite text from stdin to be more natural while preserving tone and meaning
+-g, --gitcommsg                     Generate AI-powered git commit messages from staged changes or diff file
+
+```
 
 ### Command Examples
 

{ngpt-3.12.0 → ngpt-3.12.2}/docs/usage/cli_usage.md

@@ -36,85 +36,107 @@ Where:
 
 You can set configuration options directly via command-line arguments:
 
-```
-usage: ngpt [-h] [-v] [--language LANGUAGE] [--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] [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
+```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]
+            [--temperature TEMPERATURE] [--top_p TOP_P] [--max_tokens MAX_TOKENS] [--log [FILE]]
             [--preprompt PREPROMPT | --role ROLE] [--no-stream | --prettify | --stream-prettify]
-            [--renderer {auto,rich,glow}] [--rec-chunk] [--diff [FILE]] [--chunk-size CHUNK_SIZE]
+            [--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] [-i | -s | -c | -t | -r | -g] [--humanize]
+            [--max-recursion-depth MAX_RECURSION_DEPTH] [--humanize] [--multiline] [-i | -s | -c | -t | -r | -g]
             [prompt]
 
 nGPT - Interact with AI language models via OpenAI-compatible APIs
-```
 
-### Positional Arguments
+positional arguments::
+
+[PROMPT]                            The prompt to send
+
+options::
 
-- `[PROMPT]`: The prompt to send
+-h, --help                          show this help message and exit
+-v, --version                       Show version information and exit
 
-### General Options
+Configuration Options::
 
-- `-h, --help`: Show help message and exit
-- `-v, --version`: Show version information and exit
-- `--language <LANGUAGE>`: Programming language to generate code in (for code mode)
+--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]
 
-### Configuration Options
+Global 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]
+--api-key API_KEY                   API key for the service
+--base-url BASE_URL                 Base URL for the API
+--model MODEL                       Model to use
+--web-search                        Enable web search capability using DuckDuckGo to enhance prompts with relevant
+                                    information
+--pipe                              Read from stdin and use content with prompt. Use {} in prompt as placeholder
+                                    for stdin content. Can be used with any mode option except --text and
+                                    --interactive
+--temperature TEMPERATURE           Set temperature (controls randomness, default: 0.7)
+--top_p TOP_P                       Set top_p (controls diversity, default: 1.0)
+--max_tokens MAX_TOKENS             Set max response length in tokens
+--log [FILE]                        Set filepath to log conversation to, or create a temporary log file if no path
+                                    provided
+--preprompt PREPROMPT               Set custom system prompt to control AI behavior
+--role ROLE                         Use a predefined role to set system prompt (mutually exclusive with
+                                    --preprompt)
+--renderer {auto,rich,glow}         Select which markdown renderer to use with --prettify or --stream-prettify
+                                    (auto, rich, or glow)
 
-### Global Options
+Output Display Options (mutually exclusive)::
 
-- `--api-key <API_KEY>`: API key for the service
-- `--base-url <BASE_URL>`: Base URL for the API
-- `--model <MODEL>`: Model to use
-- `--web-search`: Enable web search capability using DuckDuckGo to enhance prompts with relevant information
-- `--pipe`: Read from stdin and use content with prompt. Use {} in prompt as placeholder for stdin content. Can be used with any mode option except --text and --interactive
-- `--temperature <TEMPERATURE>`: Set temperature (controls randomness, default: 0.7)
-- `--top_p <TOP_P>`: Set top_p (controls diversity, default: 1.0)
-- `--max_tokens <MAX_TOKENS>`: Set max response length in tokens
-- `--log <[FILE]>`: Set filepath to log conversation to, or create a temporary log file if no path provided
-- `--preprompt <PREPROMPT>`: Set custom system prompt to control AI behavior
-- `--role <ROLE>`: Use a predefined role to set system prompt (mutually exclusive with --preprompt)
-- `--renderer <{auto,rich,glow}>`: Select which markdown renderer to use with --prettify or --stream-prettify (auto, rich, or glow)
+--no-stream                         Return the whole response without streaming or formatting
+--prettify                          Render complete response with markdown and code formatting (non-streaming)
+--stream-prettify                   Stream response with real-time markdown rendering (default)
 
-### Output Display Options (mutually exclusive)
+Code Mode Options::
 
-- `--no-stream`: Return the whole response without streaming or formatting
-- `--prettify`: Render complete response with markdown and code formatting (non-streaming)
-- `--stream-prettify`: Stream response with real-time markdown rendering (default)
+--language LANGUAGE                 Programming language to generate code in (for code mode)
 
-### Git Commit Message Options
+Git Commit Message Options::
 
-- `--rec-chunk`: Process large diffs in chunks with recursive analysis if needed
-- `--diff <[FILE]>`: Use diff from specified file instead of staged changes. If used without a path, uses the path from CLI config.
-- `--chunk-size <CHUNK_SIZE>`: Number of lines per chunk when chunking is enabled (default: 200)
-- `--analyses-chunk-size <ANALYSES_CHUNK_SIZE>`: Number of lines per chunk when recursively chunking analyses (default: 200)
-- `--max-msg-lines <MAX_MSG_LINES>`: Maximum number of lines in commit message before condensing (default: 20)
-- `--max-recursion-depth <MAX_RECURSION_DEPTH>`: Maximum recursion depth for commit message condensing (default: 3)
+--rec-chunk                         Process large diffs in chunks with recursive analysis if needed
+--diff [FILE]                       Use diff from specified file instead of staged changes. If used without a path,
+                                    uses the path from CLI config.
+--chunk-size CHUNK_SIZE             Number of lines per chunk when chunking is enabled (default: 200)
+--analyses-chunk-size ANALYSES_CHUNK_SIZE
+                                    Number of lines per chunk when recursively chunking analyses (default: 200)
+--max-msg-lines MAX_MSG_LINES       Maximum number of lines in commit message before condensing (default: 20)
+--max-recursion-depth MAX_RECURSION_DEPTH
+                                    Maximum recursion depth for commit message condensing (default: 3)
 
-### Modes (mutually exclusive)
+Rewrite Mode Options::
 
-- `-i, --interactive`: Start an interactive chat session
-- `-s, --shell`: Generate and execute shell commands
-- `-c, --code`: Generate code
-- `-t, --text`: Enter multi-line text input (submit with Ctrl+D)
-- `-r, --rewrite`: Rewrite text from stdin to be more natural while preserving tone and meaning
-- `-g, --gitcommsg`: Generate AI-powered git commit messages from staged changes or diff file
+--humanize                          Transform AI-generated text into human-like content that passes AI detection
+                                    tools
 
-### Rewrite Mode Options
+Interactive Mode Options::
 
-- `--humanize`: Transform AI-generated text into human-like content that passes AI detection tools
+--multiline                         Enable multiline text input with the "ml" command in interactive mode
+
+Modes (mutually exclusive)::
+
+-i, --interactive                   Start an interactive chat session
+-s, --shell                         Generate and execute shell commands
+-c, --code                          Generate code
+-t, --text                          Enter multi-line text input (submit with Ctrl+D)
+-r, --rewrite                       Rewrite text from stdin to be more natural while preserving tone and meaning
+-g, --gitcommsg                     Generate AI-powered git commit messages from staged changes or diff file
+
+```
 
 ## Mode Details
 

{ngpt-3.12.0 → ngpt-3.12.2}/ngpt/cli/args.py

@@ -30,9 +30,6 @@ def setup_argument_parser():
     # Version flag
     parser.add_argument('-v', '--version', action=ColoredVersionAction, nargs=0, 
                         help='Show version information and exit')
-    # Language option for code mode
-    parser.add_argument('--language', default="python", 
-                        help='Programming language to generate code in (for code mode)')
     
     # Prompt argument
     parser.add_argument('prompt', nargs='?', default=None, 
@@ -104,6 +101,11 @@ def setup_argument_parser():
     global_group.add_argument('--renderer', choices=['auto', 'rich', 'glow'], default='auto',
                       help='Select which markdown renderer to use with --prettify or --stream-prettify (auto, rich, or glow)')
     
+    # Code Mode Options
+    code_group = parser.add_argument_group('Code Mode Options')
+    code_group.add_argument('--language', default="python", 
+                      help='Programming language to generate code in (for code mode)')
+    
     # GitCommit message options
     gitcommsg_group = parser.add_argument_group('Git Commit Message Options')
     gitcommsg_group.add_argument('--rec-chunk', action='store_true',

{ngpt-3.12.0 → ngpt-3.12.2}/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":

{ngpt-3.12.0 → ngpt-3.12.2}/ngpt/utils/cli_config.py

@@ -288,6 +288,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.0 → ngpt-3.12.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ngpt"
-version = "3.12.0"
+version = "3.12.2"
 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.0 → ngpt-3.12.2}/uv.lock

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