janito 2.7.0__tar.gz → 2.8.0__tar.gz

{janito-2.7.0 → janito-2.8.0}/.gitattributes

@@ -1,3 +1,6 @@
+# Ensure LF line endings for Python files
+*.py text eol=lf
+
 # Prevent Git from modifying line endings (preserve existing format)
 * -text
 

{janito-2.7.0 → janito-2.8.0}/.pre-commit-config.yaml

@@ -15,3 +15,9 @@ repos:
     rev: v2.4.1
     hooks:
       - id: codespell
+
+  - repo: https://github.com/psf/black
+    rev: 25.1.0  # Use the latest stable version
+    hooks:
+      - id: black
+        language_version: python3

{janito-2.7.0 → janito-2.8.0}/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.8.0] - 2025-07-16
+### Added
+- **Groq provider**: New provider with support for moonshotai/kimi-k2-instruct model.
+- **Parallel tool calls**: Enabled for OpenAI provider when tools are available.
+- **No-tools mode**: New CLI option to disable all tool usage.
+- **Disabled tools functionality**: Support for selectively disabling specific tools.
+
+### Changed
+- **Configuration system**: Simplified by removing provider-specific settings.
+- **Max wait time**: Increased from 300s to 600s in LLMAgent for better handling of long-running operations.
+- **Custom system prompt UX**: Improved profile selection flow and user experience.
+- **OpenAI dependency**: Updated to require openai>=1.68.0.
+- **Code formatting**: Applied black formatting across the codebase.
+
+### Removed
+- **MistralAI provider**: Completely removed from the codebase.
+- **Provider-specific settings**: Simplified configuration system.
+
+### Documentation
+- Updated MoonshotAI setup guide with platform.moonshot.ai domain.
+- Improved CLI usage documentation and fixed syntax highlighting.
+- Removed broken references to model_info.py files in supported-providers-models.md.
+- Added comprehensive documentation updates across the project.
+
 ## [2.5.0] - 2025-07-01
 ### Added
 - Show working directory in chat mode startup message.

{janito-2.7.0 → janito-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janito
-Version: 2.7.0
+Version: 2.8.0
 Summary: A new Python package called janito.
 Author-email: João Pinto <lamego.pinto@gmail.com>
 Project-URL: Homepage, https://github.com/janito-dev/janito
@@ -18,6 +18,7 @@ Requires-Dist: lxml>=5.4.0
 Requires-Dist: requests>=2.32.4
 Requires-Dist: bs4>=0.0.2
 Requires-Dist: questionary>=2.0.1
+Requires-Dist: openai>=1.68.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
@@ -107,7 +108,7 @@ janito -set provider=PROVIDER
 
 ## Usage
 
-After installation, use the `janito` command in your terminal.
+After installation, use the `janito` command in your terminal with the syntax: `janito [options] [prompt]`
 
 Janito supports both general-purpose and specialized assistance through the use of **profiles**. Profiles allow you to select a specific system prompt template and behavior for the agent, enabling workflows tailored to different roles or tasks (e.g., developer, writer, data analyst), or to use Janito as a generic AI assistant.
 
@@ -202,14 +203,7 @@ janito -r -w -x "Run this code: print('Hello, world!')"
   janito -p google -m gemini-2.5-flash "Your prompt here"
   ```
 
-- **Set Provider-Specific Config (for the selected provider)**
-  ```bash
-  # syntax: janito --set PROVIDER.KEY=VALUE
-  # example: set the default model for openai provider
-  janito --set openai.model=gpt-4o
 
-  ```
-  > **Note:** Use `--set PROVIDER.key=value` for provider-specific settings (e.g., `openai.max_tokens`, `openai.base_url`).
 
 - **Enable Event Logging**
   ```bash
@@ -235,7 +229,7 @@ janito -r -w -x "Run this code: print('Hello, world!')"
 | `-v`, `--verbose`      | Print extra information before answering                                    |
 | `-R`, `--raw`          | Print raw JSON response from API                                            |
 | `-e`, `--event-log`    | Log events to console as they occur                                         |
-| `"user_prompt"`        | Prompt to submit for the non interactive mode (e.g. `janito "What is the capital of France?"`) |
+| `prompt`        | Prompt to submit for the non interactive mode (e.g. `janito "What is the capital of France?"`) |
 
 ### 🧩 Extended Chat Mode Commands
 Once inside the interactive chat mode, you can use these slash commands:
@@ -265,8 +259,6 @@ Once inside the interactive chat mode, you can use these slash commands:
 | `/tools`             | List available tools                         |
 | `/-status`           | Show status of server                       |
 | `/-logs`             | Show last lines of logs                     |
-| `/livelogs`          | Show live updates from server log file     |
-| `/edit <filename>`   | Open file in browser-based editor          |
 | `/write [on\|off]`   | Enable or disable write tool permissions   |
 | `/read [on\|off]`    | Enable or disable read tool permissions    |
 | `/execute [on\|off]` | Enable or disable execute tool permissions |

{janito-2.7.0 → janito-2.8.0}/README.md

@@ -76,7 +76,7 @@ janito -set provider=PROVIDER
 
 ## Usage
 
-After installation, use the `janito` command in your terminal.
+After installation, use the `janito` command in your terminal with the syntax: `janito [options] [prompt]`
 
 Janito supports both general-purpose and specialized assistance through the use of **profiles**. Profiles allow you to select a specific system prompt template and behavior for the agent, enabling workflows tailored to different roles or tasks (e.g., developer, writer, data analyst), or to use Janito as a generic AI assistant.
 
@@ -171,14 +171,7 @@ janito -r -w -x "Run this code: print('Hello, world!')"
   janito -p google -m gemini-2.5-flash "Your prompt here"
   ```
 
-- **Set Provider-Specific Config (for the selected provider)**
-  ```bash
-  # syntax: janito --set PROVIDER.KEY=VALUE
-  # example: set the default model for openai provider
-  janito --set openai.model=gpt-4o
 
-  ```
-  > **Note:** Use `--set PROVIDER.key=value` for provider-specific settings (e.g., `openai.max_tokens`, `openai.base_url`).
 
 - **Enable Event Logging**
   ```bash
@@ -204,7 +197,7 @@ janito -r -w -x "Run this code: print('Hello, world!')"
 | `-v`, `--verbose`      | Print extra information before answering                                    |
 | `-R`, `--raw`          | Print raw JSON response from API                                            |
 | `-e`, `--event-log`    | Log events to console as they occur                                         |
-| `"user_prompt"`        | Prompt to submit for the non interactive mode (e.g. `janito "What is the capital of France?"`) |
+| `prompt`        | Prompt to submit for the non interactive mode (e.g. `janito "What is the capital of France?"`) |
 
 ### 🧩 Extended Chat Mode Commands
 Once inside the interactive chat mode, you can use these slash commands:
@@ -234,8 +227,6 @@ Once inside the interactive chat mode, you can use these slash commands:
 | `/tools`             | List available tools                         |
 | `/-status`           | Show status of server                       |
 | `/-logs`             | Show last lines of logs                     |
-| `/livelogs`          | Show live updates from server log file     |
-| `/edit <filename>`   | Open file in browser-based editor          |
 | `/write [on\|off]`   | Enable or disable write tool permissions   |
 | `/read [on\|off]`    | Enable or disable read tool permissions    |
 | `/execute [on\|off]` | Enable or disable execute tool permissions |

janito-2.8.0/UPDATING_DOCS.md

@@ -0,0 +1,46 @@
+# Updating Documentation
+
+This project uses [MkDocs](https://www.mkdocs.org/) for documentation generation and hosting.
+
+## Documentation Structure
+
+- Documentation source files are located in the `docs/` directory
+- The main configuration is in `mkdocs.yml` at the project root
+- Documentation is written in Markdown format
+
+## When to Update Documentation
+
+Documentation should be updated whenever:
+
+- New features are added
+- Existing functionality changes
+- APIs or interfaces are modified
+- Configuration options are added or changed
+- Setup/installation instructions need updates
+- Examples or usage patterns change
+
+## How to Update Documentation
+
+1. Edit the relevant `.md` files in the `docs/` directory
+2. **Update navigation**: If adding new documentation files, update the `nav:` section in `mkdocs.yml` to include the new pages
+3. Test your changes locally by running: `mkdocs serve`
+4. Preview the documentation at `http://localhost:8000`
+5. Once satisfied, commit your changes along with the code changes
+
+## Building and Deploying
+
+- Local development: `mkdocs serve`
+- Build static site: `mkdocs build`
+- Deploy to GitHub Pages: `mkdocs gh-deploy` (if configured)
+
+## MkDocs Configuration
+
+The `mkdocs.yml` file contains:
+
+- Site metadata (name, description, etc.)
+- **Navigation structure** (`nav:` section) - must be updated when adding new documentation files
+- Theme configuration
+- Plugin settings
+- Markdown extensions
+
+Please ensure any documentation updates maintain consistency with the existing style and structure. When adding new documentation files, always remember to update the navigation in `mkdocs.yml`.

{janito-2.7.0 → janito-2.8.0}/docs/guides/configuration.md

@@ -34,6 +34,25 @@ Show the current configuration with:
 janito --show-config
 ```
 
+## Advanced Configuration
+
+### Disabling Tools
+
+You can selectively disable specific tools to customize your workflow or enhance security:
+
+```bash
+# Disable a single tool
+janito --set disabled_tools=ask_user
+
+# Disable multiple tools
+janito --set disabled_tools="ask_user,python_code_run"
+
+# View disabled tools
+janito --show-config
+```
+
+See the [Disabling Tools Guide](disabled-tools.md) for complete details.
+
 ## More Information
 
 - See [CLI Options Reference](../reference/cli-options.md) for all configuration flags.

janito-2.8.0/docs/guides/disabled-tools.md

@@ -0,0 +1,121 @@
+# Disabling Tools Guide
+
+Janito allows you to disable specific tools to customize your workflow or enhance security. This guide explains how to disable and manage tools using configuration settings.
+
+## Overview
+
+By default, all tools are enabled based on their permission requirements (read, write, execute). However, you can selectively disable individual tools using the `disabled_tools` configuration setting.
+
+## Setting Disabled Tools
+
+### Via CLI
+
+Use the `--set` command to disable tools:
+
+```bash
+# Disable a single tool
+janito --set disabled_tools=ask_user
+
+# Disable multiple tools (comma-separated)
+janito --set disabled_tools="ask_user,python_code_run"
+
+# Clear all disabled tools
+janito --set disabled_tools=""
+```
+
+### Via Configuration File
+
+Edit your `config.json` file (located in `~/.janito/config.json`) and add the `disabled_tools` key:
+
+```json
+{
+  "disabled_tools": "ask_user,python_code_run",
+  "provider": "openai",
+  "model": "gpt-4.1"
+}
+```
+
+## Viewing Disabled Tools
+
+Check which tools are currently disabled:
+
+```bash
+janito --show-config
+```
+
+This will display a section showing your disabled tools, for example:
+```
+Disabled tools: ask_user, python_code_run
+```
+
+## Listing Available Tools
+
+To see which tools are currently available (excluding disabled ones):
+
+```bash
+janito --list-tools
+```
+
+Disabled tools will not appear in the tool listing.
+
+## Common Use Cases
+
+### Security Enhancement
+Disable potentially dangerous tools in production environments:
+```bash
+janito --set disabled_tools="python_code_run,run_powershell_command,run_bash_command"
+```
+
+### Workflow Customization
+Disable tools you don't use to reduce clutter:
+```bash
+janito --set disabled_tools="open_url,open_html_in_browser"
+```
+
+### Temporary Disabling
+Temporarily disable tools for specific sessions:
+```bash
+janito --set disabled_tools=ask_user "Generate code without user interaction"
+```
+
+## Tool Names
+
+Use the exact tool names as shown in `janito --list-tools`. Common tool names include:
+
+- `ask_user` - Interactive user prompts
+- `python_code_run` - Execute Python code
+- `run_powershell_command` - Execute PowerShell commands
+- `run_bash_command` - Execute bash commands
+- `create_file` - Create new files
+- `remove_file` - Delete files
+- `open_url` - Open URLs in browser
+- And many more...
+
+## Best Practices
+
+1. **Test Before Disabling**: Always test your workflow after disabling tools to ensure essential functionality isn't broken.
+
+2. **Document Changes**: Keep track of which tools you've disabled and why.
+
+3. **Use Sparingly**: Only disable tools that pose security risks or aren't needed for your specific use case.
+
+4. **Review Regularly**: Periodically review your disabled tools list to ensure it still meets your needs.
+
+## Troubleshooting
+
+### Tool Still Appears Available
+
+- Ensure you're using the exact tool name (case-sensitive)
+- Check that the configuration was saved: `janito --show-config`
+- Restart your terminal session if needed
+
+### Accidentally Disabled Essential Tools
+
+- Clear all disabled tools: `janito --set disabled_tools=""`
+- Or selectively re-enable by removing from the comma-separated list
+
+### Configuration Not Persisting
+
+- Verify the config file path: `janito --show-config` shows the location
+- Check file permissions for your `~/.janito/config.json` file
+- Ensure no syntax errors in the JSON configuration

{janito-2.7.0 → janito-2.8.0}/docs/guides/terminal-shell.md

@@ -10,7 +10,7 @@ The interactive shell lets you have a continuous conversation with Janito, just
 - 📋 Copy code snippets easily
 - 💡 Context-aware suggestions (where supported)
 - 💾 Conversation state is saved/restored between sessions
-- 🖱️ **Clickable file links**: Click on file names in responses to open them in a web viewer for detailed inspection and actions (see below)
+
 
 --- 
 
@@ -39,16 +39,7 @@ You can use these commands at any time (prefix with `/` or just type the name):
 | `/execute [on|off] | /read [on|off] | /write [on|off]`       | Enable or disable code/shell execution tools at runtime          |
 | `/tools`               | List all registered tools and show which are enabled/disabled     |
 
-## 🖱️ Clickable File Links
-
-When Janito references files in its responses, the file names may appear as clickable links in supported terminals or web-based shells. To enable this, start Janito with the `--web` flag. Clicking these links will open the file in your browser for inspection.
-
-- **What you can do:**
-  - View file contents in your browser
-  - Access additional actions (e.g., copy, download, or inspect details)
-  - Navigate project files more efficiently during reviews or debugging
 
-This feature enhances productivity by bridging the terminal and browser, making it easy to inspect and act on files referenced in your conversations.
 
 ## 💻 Usage Example
 

{janito-2.7.0 → janito-2.8.0}/docs/index.md

@@ -20,5 +20,6 @@ Janito is a lightweight language model client focused on software development ac
 
 - [What Is a Language Model Client?](concepts/language-model-clients.md) — Thin vs. Thick Clients explained
 - [Configuring Janito for DeepSeek](deepseek-setup.md) — How to set up and use DeepSeek models
+- [Configuring Janito for MoonshotAI](moonshotai-setup.md) — How to set up and use MoonshotAI models
 - **Concepts & Terminology:** See the [concepts](concepts/index.md) section for more foundational explanations.
 

{janito-2.7.0 → janito-2.8.0}/docs/llm-drivers.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-The driver layer described below is intended to provide a unified, event-driven interface for interacting with various Large Language Model (LLM) providers (such as OpenAI, Google Gemini, MistralAI, etc.). However, as of this writing, the actual driver code (including the LLMDriver base class and its subclasses) is not present in this directory. The following describes the intended architecture and requirements, but no implementation is currently available here.
+The driver layer described below is intended to provide a unified, event-driven interface for interacting with various Large Language Model (LLM) providers (such as OpenAI, Google Gemini, etc.). However, as of this writing, the actual driver code (including the LLMDriver base class and its subclasses) is not present in this directory. The following describes the intended architecture and requirements, but no implementation is currently available here.
 
 ## Key Concepts
 

janito-2.8.0/docs/moonshotai-setup.md

@@ -0,0 +1,74 @@
+# Configuring Janito for MoonshotAI
+
+Janito supports MoonshotAI as an LLM provider. This guide explains how to configure Janito to use MoonshotAI models.
+
+## 1. Obtain a MoonshotAI API Key
+
+- Sign up or log in at [Moonshot AI Platform](https://platform.moonshot.ai) to get your API key.
+- Navigate to the API Keys section in your dashboard to create and manage your keys.
+
+## 2. Set Your MoonshotAI API Key in Janito
+
+You must specify both the API key and the provider name when configuring Janito for MoonshotAI:
+
+```bash
+janito --set-api-key YOUR_MOONSHOT_API_KEY -p moonshotai
+```
+
+Replace `YOUR_MOONSHOT_API_KEY` with your actual MoonshotAI API key.
+
+## 3. Select MoonshotAI as the Provider
+
+You can set MoonshotAI as your default provider:
+
+```bash
+janito --set provider=moonshotai
+```
+
+Or specify it per command:
+
+```bash
+janito -p moonshotai "Your prompt here"
+```
+
+## 4. Choose a MoonshotAI Model
+
+Janito supports the following MoonshotAI models:
+
+- `kimi-k2-0711-preview` (default) - Advanced reasoning model with 128k context window
+- `kimi-k1-8k` - Standard model with 8k context window
+- `kimi-k1-32k` - Standard model with 32k context window
+- `kimi-k1-128k` - Standard model with 128k context window
+
+To select a model:
+
+```bash
+janito -p moonshotai -m kimi-k1-32k "Your prompt here"
+```
+
+## 5. Verify Your Configuration
+
+Show your current configuration:
+
+```bash
+janito --show-config
+```
+
+## 6. API Endpoint Information
+
+MoonshotAI uses an OpenAI-compatible API endpoint:
+
+- **Base URL**: `https://api.moonshot.ai/v1`
+- **Authentication**: Bearer token (API key)
+- **Format**: OpenAI API format
+
+## 7. Troubleshooting
+
+- Ensure your API key is correct and has sufficient credits.
+- If you encounter issues, use `janito --list-providers` to verify MoonshotAI is available.
+- Check your API key permissions and rate limits in the Moonshot AI Platform dashboard.
+- For more help, see the main [Configuration Guide](guides/configuration.md) or run `janito --help`.
+
+---
+
+For more details on supported models and features, see [Supported Providers & Models](supported-providers-models.md).

{janito-2.7.0 → janito-2.8.0}/docs/reference/azure-openai.md

@@ -19,7 +19,7 @@ Janito supports models hosted on Azure OpenAI in addition to OpenAI-compatible e
 3. **(Optional) Set API version:**
    If you need a specific API version, set `azure_openai_api_version` (default: `2023-05-15`).
    ```bash
-   janito --set-local-config azure_openai_api_version=2023-05-15
+   janito --set azure_openai_api_version=2023-05-15
    ```
 
 ## Example Configuration

{janito-2.7.0 → janito-2.8.0}/docs/reference/cli-options.md

@@ -2,6 +2,8 @@
 
 This page documents all command-line options for Janito, as shown by `janito --help`. These options temporarily override configuration for a single session and do not persist changes to config files.
 
+**Syntax:** `janito [options] [prompt]`
+
 ## 💡 Overview
 
 These options are useful for one-off runs, scripting, or experimentation. They take precedence over config files for the current invocation only.
@@ -10,7 +12,7 @@ These options are useful for one-off runs, scripting, or experimentation. They t
 
 | Option | Description |
 |--------|-------------|
-| `user_prompt` | Prompt to submit (positional argument) |
+| `prompt` | Prompt to submit (optional positional argument) |
 | `-h`, `--help` | Show this help message and exit |
 | `--verbose-api` | Print API calls and responses of LLM driver APIs for debugging/tracing. |
 | `--verbose-tools` | Print info messages for tool execution in tools adapter. |
@@ -27,7 +29,7 @@ These options are useful for one-off runs, scripting, or experimentation. They t
 | `--list-providers` | List supported LLM providers |
 | `-l`, `--list-models` | List all supported models |
 | `--set-api-key API_KEY` | Set API key for the provider (requires -p PROVIDER) |
-| `--set [PROVIDER_NAME.]KEY=VALUE` | Set a config key |
+| `--set KEY=VALUE` | Set a config key |
 | `-s SYSTEM_PROMPT`, `--system SYSTEM_PROMPT` | Set a system prompt |
 | `-S`, `--show-system` | Show the resolved system prompt for the main agent |
 
@@ -36,7 +38,7 @@ These options are useful for one-off runs, scripting, or experimentation. They t
 | `-t TEMPERATURE`, `--temperature TEMPERATURE` | Set the temperature |
 | `-v`, `--verbose` | Print extra information before answering |
 | `-R`, `--raw` | Print the raw JSON response from the OpenAI API (if applicable) |
-| `--web` | Enable the builtin lightweight web file viewer for terminal links (disabled by default) |
+
 
 | `--effort {low, medium, high, none}` | Set the reasoning effort for models that support it (low, medium, high, none) |
 | `-e`, `--event-log` | Enable event logging to the system bus |
@@ -45,6 +47,7 @@ These options are useful for one-off runs, scripting, or experimentation. They t
 ## 👨‍💻 Usage Example
 
 ```sh
+janito [options] [prompt]
 janito -p openai -m gpt-3.5-turbo "Your prompt here"
 janito -p google -m gemini-2.5-flash "Your prompt here"
 janito --list-tools
@@ -82,3 +85,18 @@ The `--effort` option allows you to set the reasoning effort for models that sup
 - `none`: Disables special reasoning effort (model default)
 
 > **Note:** Not all models or providers support this option. If unsupported, the option may be ignored.
+
+## 🔧 Configuration Keys
+
+The `--set` command supports the following configuration keys:
+
+| Key | Description | Example |
+|-----|-------------|---------|
+| `provider` | Set the default provider | `--set provider=openai` |
+| `model` | Set the default model | `--set model=gpt-4.1` |
+| `max_tokens` | Set maximum tokens | `--set max_tokens=4000` |
+| `base_url` | Set custom API base URL | `--set base_url=https://api.example.com` |
+| `tool_permissions` | Set tool permission level | `--set tool_permissions=rwe` |
+| `disabled_tools` | Disable specific tools | `--set disabled_tools=ask_user,python_code_run` |
+
+For more details on disabling tools, see the [Disabling Tools Guide](../guides/disabled-tools.md).

janito-2.8.0/docs/supported-providers-models.md

@@ -0,0 +1,28 @@
+# Supported Providers and Models
+
+This page lists the supported providers and their available models.
+
+## OpenAI
+- GPT-3.5 Turbo
+- GPT-4
+- GPT-4 Turbo
+
+## Google
+- Gemini Pro
+- Gemini 1.5 Pro
+
+## Anthropic
+- Claude 2
+- Claude 3 Opus
+- Claude 3 Sonnet
+- Claude 3 Haiku
+
+## MoonshotAI
+- Moonshot-v1-8k
+- Moonshot-v1-32k
+
+## Groq
+- Llama-3-8b-8192
+- Llama-3-70b-8192
+
+<!-- Removed links to model_info.py files for all providers to avoid broken references. -->

janito-2.8.0/docs/tools/search-text.md

@@ -0,0 +1,64 @@
+# 🔍 search_text
+
+Search for a text query in all files within one or more directories or file paths and return matching lines or counts. Respects `.gitignore`.
+
+## Signature
+
+```python
+search_text(
+    paths: str,
+    query: str,
+    use_regex: bool = False,
+    case_sensitive: bool = False,
+    max_depth: int = 0,
+    max_results: int = 100,
+    count_only: bool = False,
+) -> str
+```
+
+## Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `paths` | `str` | required | Space-separated list of file or directory paths to search in. |
+| `query` | `str` | required | Text or regular expression to search for. Must not be empty. |
+| `use_regex` | `bool` | `False` | If `True`, treat `query` as a regular expression. If `False`, treat as plain text. |
+| `case_sensitive` | `bool` | `False` | If `False`, perform a case-insensitive search. |
+| `max_depth` | `int` | `0` | Maximum directory depth to search. `0` = unlimited recursion. `1` = top-level only. |
+| `max_results` | `int` | `100` | Maximum number of matching lines to return. `0` = no limit. |
+| `count_only` | `bool` | `False` | If `True`, return only match counts instead of the actual lines. |
+
+## Returns
+
+- **Lines mode** (`count_only=False`): newline-separated list of matches, each formatted as:
+  ```
+  filepath:lineno: line content
+  ```
+- **Count mode** (`count_only=True`): summary of matches per file plus a total.
+
+## Examples
+
+### Plain-text search
+```bash
+search_text(paths="src", query="TODO")
+```
+
+### Regex search
+```bash
+search_text(paths="src tests", query=r"def\s+\w+", use_regex=True)
+```
+
+### Case-insensitive count
+```bash
+search_text(paths="docs", query="janito", case_sensitive=False, count_only=True)
+```
+
+### Limit depth
+```bash
+search_text(paths=".", query="import", max_depth=1)
+```
+
+### Unlimited results
+```bash
+search_text(paths=".", query="print", max_results=0)
+```