janito 0.13.0__py3-none-any.whl → 0.15.0__py3-none-any.whl

{janito-0.13.0.dist-info → janito-0.15.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janito
-Version: 0.13.0
+Version: 0.15.0
 Summary: Janito CLI tool
 Project-URL: Homepage, https://github.com/joaompinto/janito
 Author-email: João Pinto <lamego.pinto@gmail.com>
@@ -31,12 +31,13 @@ Janito is a powerful AI-assisted command-line interface (CLI) tool built with Py
 - 🔍 Smart code search and editing
 - 💻 Interactive terminal interface with rich formatting
 - 📊 Detailed token usage tracking and cost reporting with cache savings analysis
-- 🛑 Token and tool usage reporting even when interrupted with Ctrl+C
 - 🌐 Web page fetching with content extraction capabilities
 - 🔄 Parameter profiles for optimizing Claude's behavior for different tasks
 - 📋 Line delta tracking to monitor net changes in files
-- 💬 Conversation history with ability to resume previous conversations
+- 💬 Enhanced conversation history with browsing and management
 - 🔇 Trust mode for concise output without tool details
+- 🚫 No-tools mode for pure AI interactions without file system access
+- 📝 Custom system instructions for specialized assistant behavior
 
 ## 🛠️ System Requirements
 
@@ -115,31 +116,60 @@ janito --trust "Optimize the HTML code"
 # Or use the short alias
 janito -t "Optimize the HTML code"
 
+# Disable all tools for pure AI interaction
+janito --no-tools "Explain how HTML works"
+
+# View your conversation history
+janito --history
+
+# View a specific number of recent conversations
+janito --history 10
+
 # Continue the most recent conversation
 janito --continue "Please add one more line"
 
 # Continue a specific conversation using its message ID
 # (Janito displays the message ID after each conversation)
-janito --continue abc123def "Let's refine that code"
+janito --continue "abc123def" "Let's refine that code"
+
+# Alternative way to continue a specific conversation
+janito --continue-id abc123def "Let's refine that code"
+
+# Provide custom system instructions
+janito --system "You are a poetry expert who speaks in rhymes" "Write about coding"
+# Or use the short alias
+janito -s "You are a poetry expert who speaks in rhymes" "Write about coding"
 
 # Show current configuration and available profiles
 janito --show-config
 
+# Set a local configuration value (applies to current workspace only)
+janito --set-local-config "temperature=0.7"
+
+# Set a global configuration value (applies to all workspaces by default)
+janito --set-global-config "profile=creative"
+
+# Reset local configuration
+janito --reset-local-config
+
+# Reset global configuration
+janito --reset-global-config
+
 # You can press Ctrl+C at any time to interrupt a query
-# Janito will still display token and tool usage information
-# Even interrupted conversations can be continued with --continue
+# Interrupted conversations can be continued with --continue
 ```
 
 ## 🔧 Available Tools
 
 Janito comes with several built-in tools:
-- 📄 `str_replace_editor` - View, create, and edit files
+- 📄 `str_replace_editor` - View, create, and edit files with configurable display limits
 - 🔎 `find_files` - Find files matching patterns
 - 🗑️ `delete_file` - Delete files
 - 🔍 `search_text` - Search for text patterns in files
 - 🌐 `fetch_webpage` - Fetch and extract content from web pages
 - 📋 `move_file` - Move files from one location to another
 - 💻 `bash` - Execute bash commands with real-time output display
+- 🧠 `think` - Tool to record thoughts for complex reasoning
 
 ## 📊 Usage Tracking
 
@@ -153,6 +183,24 @@ Janito includes a comprehensive token usage tracking system that helps you monit
   - Cache performance metrics with savings analysis
   - Line delta tracking for file modifications
 
+## 📄 Enhanced File Viewing
+
+The str_replace_editor tool now includes improved file viewing capabilities:
+
+- **Configurable Display Limits**: Set the maximum number of lines to display before showing a warning
+- **Warning Instead of Truncation**: When a file exceeds the configured line limit, a warning is shown but the full content is still displayed
+- **Customizable Limits**: Configure the `max_view_lines` setting to adjust the threshold (default: 500 lines)
+
+```bash
+# Set a custom maximum view lines threshold globally
+janito --set-global-config "max_view_lines=1000"
+
+# Set a project-specific threshold
+janito --set-local-config "max_view_lines=250"
+```
+
+This improvement ensures you always see the complete file content while still being warned about potentially large files.
+
 ```bash
 # Show detailed token usage and cost information
 janito --show-tokens "Write a Python function to sort a list"
@@ -213,9 +261,58 @@ This feature is particularly useful for:
 - Focusing on results rather than the process
 - Creating cleaner output for documentation or sharing
 
+## 🚫 No-Tools Mode
+
+Janito provides a no-tools mode that disables all file system and external tools for pure AI interactions:
+
+### How It Works
+
+- When enabled with `--no-tools`, Janito disables all tools for the current session
+- Claude will respond based purely on its knowledge without accessing or modifying files
+- This mode is a per-session setting and not saved to your configuration
+
+### Using No-Tools Mode
+
+```bash
+# Enable no-tools mode
+janito --no-tools "Explain how Docker containers work"
+```
+
+This feature is particularly useful for:
+- Getting general information or explanations without file system access
+- Brainstorming sessions where you don't need file operations
+- Safer operation in sensitive environments
+- Faster responses for queries that don't require tools
+
+## 📝 Custom System Instructions
+
+Janito allows you to provide custom system instructions to change Claude's behavior:
+
+### How It Works
+
+- When provided with `--system` or `-s`, Janito uses your custom instructions instead of the default
+- This allows you to create specialized assistant personalities or behaviors
+- Custom instructions are a per-session setting and not saved to your configuration
+
+### Using Custom System Instructions
+
+```bash
+# Provide custom system instructions
+janito --system "You are a poetry expert who speaks in rhymes" "Write about coding"
+
+# Or use the short alias
+janito -s "You are a cybersecurity expert" "Review this authentication code"
+```
+
+This feature is particularly useful for:
+- Creating specialized assistant personalities
+- Focusing Claude on specific domains or expertise
+- Setting up specific response formats or styles
+- Educational scenarios where you need different expert perspectives
+
 ## 💬 Conversation History
 
-Janito automatically saves your conversation history, allowing you to continue previous discussions:
+Janito automatically saves your conversation history, allowing you to browse, manage, and continue previous discussions:
 
 ### How It Works
 
@@ -223,6 +320,23 @@ Janito automatically saves your conversation history, allowing you to continue p
 - The most recent conversation is also saved as `.janito/last_message.json` for backward compatibility
 - After each conversation, Janito displays the command to continue that specific conversation
 
+### Browsing Your History
+
+You can view your conversation history with the `--history` flag:
+
+```bash
+# Show the 20 most recent conversations (default)
+janito --history
+
+# Show a specific number of recent conversations
+janito --history 10
+```
+
+This displays a table with:
+- Conversation ID
+- Date and time
+- First query from each conversation
+
 ### Using the Continue Feature
 
 ```bash
@@ -231,6 +345,13 @@ janito --continue "Add more details to your previous response"
 
 # Continue a specific conversation using its ID
 janito --continue abc123def "Let's modify that code you suggested"
+
+# Just use --continue without arguments to continue the most recent conversation
+# and be prompted for your next query
+janito --continue
+
+# Alternative way to continue a specific conversation
+janito --continue-id abc123def "Let's modify that code you suggested"
 ```
 
 The `--continue` flag (or `-c` for short) allows you to:
@@ -257,23 +378,73 @@ Janito automatically installs the following dependencies:
 Janito offers a variety of command-line options to customize its behavior:
 
 ```
---verbose, -v                 Enable verbose mode with detailed output
---show-tokens                 Show detailed token usage and pricing information
---workspace, -w TEXT          Set the workspace directory
---set-config TEXT             Configuration string in format 'key=value', e.g., 'temperature=0.7'
---show-config                 Show current configuration
---reset-config                Reset configuration by removing the config file
---set-api-key TEXT            Set the Anthropic API key globally in the user's home directory
---ask                         Enable ask mode which disables tools that perform changes
---trust, -t                   Enable trust mode which suppresses tool outputs for concise execution
---temperature FLOAT           Set the temperature for model generation (0.0 to 1.0)
---profile TEXT                Use a predefined parameter profile (precise, balanced, conversational, creative, technical)
---role TEXT                   Set the assistant's role (default: 'software engineer')
---version                     Show the version and exit
---continue, -c TEXT           Continue a previous conversation, optionally with a specific message ID
---help                        Show the help message and exit
+Arguments:
+  [QUERY]                     Query to send to the claudine agent
+
+Options:
+  --verbose, -v               Enable verbose mode with detailed output
+  --show-tokens, --tokens     Show detailed token usage and pricing information
+  --workspace, -w TEXT        Set the workspace directory
+  --set-local-config TEXT     Set a local configuration value in format 'key=value' (overrides global config)
+  --set-global-config TEXT    Set a global configuration value in format 'key=value' (used as default)
+  --show-config               Show current configuration
+  --reset-local-config        Reset local configuration by removing the local config file
+  --reset-global-config       Reset global configuration by removing the global config file
+  --set-api-key TEXT          Set the Anthropic API key globally in the user's home directory
+  --ask                       Enable ask mode which disables tools that perform changes
+  --trust, -t                 Enable trust mode which suppresses tool outputs for concise execution
+  --no-tools                  Disable all tools for this session (pure AI interaction)
+  --temperature FLOAT         Set the temperature for model generation (0.0 to 1.0)
+  --profile TEXT              Use a predefined parameter profile (precise, balanced, conversational, creative, technical)
+  --role TEXT                 Set the assistant's role (default: 'software engineer')
+  --system, -s TEXT           Provide custom system instructions, bypassing the default file load method
+  --version                   Show the version and exit
+  --continue, -c [TEXT]       Continue a conversation. Can be used as: 1) --continue (to continue most recent), 
+                              2) --continue 123 (to continue conversation with ID 123), or 
+                              3) --continue "query" (to continue most recent with new query)
+  --history [N]               Show a summary of conversations. Use --history for default (20) or --history n to specify count
+  --help                      Show the help message and exit
 ```
 
+## ⚙️ Configuration System
+
+Janito uses a two-level configuration system with local and global settings:
+
+### Local vs Global Configuration
+
+- **Local Configuration**: Stored in `.janito/config.json` in your current workspace directory
+- **Global Configuration**: Stored in `~/.janito/config.json` in your home directory
+- Local settings override global settings when both are present
+- Use `--set-local-config` for project-specific settings and `--set-global-config` for user-wide defaults
+
+### Setting Configuration Values
+
+```bash
+# Set a local configuration value (applies to current workspace only)
+janito --set-local-config "temperature=0.7"
+
+# Set a global configuration value (applies to all workspaces by default)
+janito --set-global-config "profile=creative"
+
+# Reset local configuration
+janito --reset-local-config
+
+# Reset global configuration
+janito --reset-global-config
+
+# View current configuration (shows both local and global settings)
+janito --show-config
+```
+
+### Configurable Settings
+
+You can configure various settings including:
+- `profile`: Parameter profile (precise, balanced, conversational, creative, technical)
+- `temperature`: Model temperature (0.0 to 1.0)
+- `role`: Assistant's role (default: 'software engineer')
+- `ask_mode`: Enable/disable ask mode (true/false)
+- `max_view_lines`: Maximum number of lines to display before showing a warning (default: 500)
+
 ## 🔑 API Key Configuration
 
 You can configure your Anthropic API key in several ways:
@@ -295,6 +466,16 @@ Your API key is securely stored and used for all future sessions.
 
 For development instructions, please refer to [README_DEV.md](README_DEV.md).
 
+## 💡 Use Cases
+
+### Debugging Code
+
+Below is an example of using Janito to help fix a bug in your code:
+
+![Using Janito to fix a bug](docs/images/use_cases/fix_bug_example.png)
+
+Simply describe the bug to Janito, and it will help you identify and fix the issue in your code.
+
 ## 📜 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

janito-0.15.0.dist-info/RECORD

@@ -0,0 +1,64 @@
+janito/__init__.py,sha256=zsus-BGV8QuV6oDjBBKDMcceIgrr7KSYOcfkQBO657c,53
+janito/__main__.py,sha256=Oy-Nc1tZkpyvTKuq1R8oHSuJTkvptN6H93kIHBu7DKY,107
+janito/callbacks.py,sha256=E1FPXYHZUgiEGMabYuf999PSf_Su4ByHOWlc1-hMqWE,915
+janito/token_report.py,sha256=Mks7o2yTxPChgQyBJNoQ5eMmrhSgEM4LKCKi2tHJbVo,9580
+janito/cli/__init__.py,sha256=dVi9l3E86YyukjxQ-XSUnMZkghnNasXex-X5XAOBiwk,85
+janito/cli/agent.py,sha256=gIkbQZHNcg8hH52ziqklhKY6EDSyl6URUbtRvQQHqyI,414
+janito/cli/app.py,sha256=8YfBD0aiJIbKLyS1OtQW8lxDQQIEwDaVetLzRqsiqKg,9394
+janito/cli/commands.py,sha256=M0DKCFZMS1mXA-s9Lm_4Ug7LJFlNg12fBdcDOhCnIWg,380
+janito/cli/output.py,sha256=mo3hUokhrD4SWexUjCbLGGQeCDUf0369DA_i9BW7HjU,933
+janito/cli/utils.py,sha256=gO4NtCNwtEzYDsQesrFlqB5FtYuw87yGwo4iG3nINgw,661
+janito/cli/agent/__init__.py,sha256=3O3b_MnwX_-qApYlyXzXhdjT4-dHzfxpOAy1lK_ZAIE,250
+janito/cli/agent/conversation.py,sha256=iif8ciIbsb_HZaZ6qvK40s0PyW3QmriZ1Q7PtUqKfI4,5644
+janito/cli/agent/initialization.py,sha256=7EOdNAUvzx9SAwTaXSgl-qxzqwR_IsUJ475eLJdkY4M,6344
+janito/cli/agent/query.py,sha256=zblUqyy6JjmA7d2JH8sjah4Kf4iNHBgrImb4d5joxLk,4920
+janito/cli/commands/__init__.py,sha256=4zGGB0x-TeBetSArBV38SZQo0T1K59vJofhXhLiD3g0,331
+janito/cli/commands/config.py,sha256=P-ScO3_PZvlny_nlTANNzLCbExAZejQIa2Zi9VJXyP4,827
+janito/cli/commands/history.py,sha256=WzWgPRZ7mQwlbDCPw3Hapb-K_Ybk1uKLs-qLams6sO4,5409
+janito/cli/commands/profile.py,sha256=_N2jaCe5sb5CbWkX5MK2tSbqkDMwDjY-g9barusVGCI,3679
+janito/cli/commands/validation.py,sha256=ldtfk0vAOkrto1Ys6G0MDmUOQvYalHsTd_l_0fMVHcI,718
+janito/cli/commands/workspace.py,sha256=D1kDnUmSYkItVJUj7TQEKstMlj9n4TW-7F6-DngACwY,867
+janito/config/README.md,sha256=-O5yJ6S9-G34Gkr7leopYKwvn56wxApAsciQvzQ7M8U,3840
+janito/config/__init__.py,sha256=6cgEQmhc3lmHU0onB_id4H_ToU570w3WNNUpqamZJm8,627
+janito/config/cli/__init__.py,sha256=7NsEWbKFYyHurtLLTBsFsfSaeSiO7_RDlfzI6DGqbiE,785
+janito/config/cli/commands.py,sha256=YucCvzsF0KuIb0JyfuER1y3-3qTL-4QCADZEtpKOIv0,16231
+janito/config/cli/validators.py,sha256=Wl0-b_P3sKZoZG9wiFQTcU27x11lCTdz5wXLbwVc7RE,2766
+janito/config/core/__init__.py,sha256=TgaRaJ_qeG5oK3aEBZlPjOmTaUv22a1onHPz_91csao,531
+janito/config/core/file_operations.py,sha256=il_xwyY45EAxzo0rCil0Vj_3V6BHI93-z4CpK_xKIL8,2723
+janito/config/core/properties.py,sha256=vaPTCXypsZ-RyAVgQCId4OY1kOLUhZffX3uaorG7ygY,12098
+janito/config/core/singleton.py,sha256=m5dIcryOK9TPDFtAWyMCDDZRQCQ9-KXRRhQlPySy3Dw,10417
+janito/config/profiles/__init__.py,sha256=69l2e2kgy0wPqzpXWNZFrtJOnwLq6_22EUJHJs_rsm4,281
+janito/config/profiles/definitions.py,sha256=KJZQHvK6bvgnfttI7w6BqD5-477Rc7Xk3ZXAm6FPz18,1112
+janito/config/profiles/manager.py,sha256=oLx1RqIJPkmxrOXVvqWjYDZGEkWtX70uZN62kYYSD7k,2321
+janito/data/instructions_template.txt,sha256=JCH6LO_9Uo5r7yD2gRJRuCQRxpKrVY42L5jJivfo_CI,2307
+janito/tools/__init__.py,sha256=mCtmWVFfgrk_SFWcwzw92O9Fb9P-5SYnO2rPMxkT5rM,1624
+janito/tools/decorators.py,sha256=Tp48n5y4LKsjyV3HeOA9wk2dV413RrEG-23kRyQVlKs,2522
+janito/tools/delete_file.py,sha256=UrZ5q59SIxWfuJcqgol6yPBqL-RhO9lFCF4MqAc6o00,2252
+janito/tools/find_files.py,sha256=c_N9ETcRPprQeuZYanwFnl-9E05ZqUYhNVoCRS5uqQg,8300
+janito/tools/move_file.py,sha256=EkSKFXY47HU7gNpLA4H4z7S3oD5iWkyb55iS2r6jB3E,2732
+janito/tools/prompt_user.py,sha256=OnTiWVBCbL_2MYu7oThlKr8X_pnYdG-dzxXSOgJF41c,1942
+janito/tools/replace_file.py,sha256=i4GoLtS14eKSU5lYI18mJ96S0_ekeHMwlQfazg-fxrM,2296
+janito/tools/rich_console.py,sha256=0zWYRF8qk4N-upuwswUSEfYFAfkEYDYeCgxst-czWtY,6044
+janito/tools/search_text.py,sha256=GXc8fuqKD6r0dEr2lMs5LrYYMM5RtTApvMXlvdt2ZiY,8839
+janito/tools/think.py,sha256=VsfYzYSfdBz6ayUYE8aoeAsdeN2PFpHjwUkxtaw1YYQ,1204
+janito/tools/usage_tracker.py,sha256=3qHXIs9rzm0oY2iaaFHqlLre6ZoWicZgOc46s6XyGc0,4681
+janito/tools/bash/bash.py,sha256=lY6OX7EgxkkBHmQpTwoe53onxfaA-z4UCE1hdRhqYos,6522
+janito/tools/bash/unix_persistent_bash.py,sha256=PxwYU-YNTBixp4RgecoVPGnfqVNjy8u3ScIkzfQfT18,8522
+janito/tools/bash/win_persistent_bash.py,sha256=aglpYIF6JZJiER5c2IBPqM5ufo096y96qtuzA34TKX8,14339
+janito/tools/fetch_webpage/__init__.py,sha256=Rnzni75VX1JfmGJ2LHckGWQqr7xC95wahh5Q-1PlncQ,514
+janito/tools/fetch_webpage/core.py,sha256=3Q8dAlWYMU_Mg8DyrNCBaLuriAxItSYIyGAcPZFktcI,7555
+janito/tools/str_replace_editor/__init__.py,sha256=kYmscmQgft3Jzt3oCNz7k2FiRbJvku6OFDDC3Q_zoAA,144
+janito/tools/str_replace_editor/editor.py,sha256=BckYfiMRUYDfDrbu871qMt2AfZexth_02QhwYYOd53g,2489
+janito/tools/str_replace_editor/utils.py,sha256=akiPqCHjky_RwL9OitHJJ7uQ-3fNaA8wt_K_YO1EP6I,954
+janito/tools/str_replace_editor/handlers/__init__.py,sha256=RP6JCeDRIL4R-lTpGowIoOAi64gg6VxZvJGp8Q2UOVU,373
+janito/tools/str_replace_editor/handlers/create.py,sha256=s8RQE04kDAL7OLZA8WxJkDqTmJlGmCNiit4tIHnmNMo,2470
+janito/tools/str_replace_editor/handlers/insert.py,sha256=eKHodm2ozKUlRMxWMLAsu9ca6unUo1jfXWwHSld-pSU,4061
+janito/tools/str_replace_editor/handlers/str_replace.py,sha256=RciLTlA7R2PGljeeyluLcBHUAje9c1OCxm-bFE7j6iY,4473
+janito/tools/str_replace_editor/handlers/undo.py,sha256=3OIdAWkpXC2iDe94_sfx_WxEFh3a1cRzoP0NtPXq1Ks,2491
+janito/tools/str_replace_editor/handlers/view.py,sha256=5NEdWM53oqofdbQNw3DU86icai2BWdf0WzeIAgZIzzg,7158
+janito/data/instructions_template.txt,sha256=JCH6LO_9Uo5r7yD2gRJRuCQRxpKrVY42L5jJivfo_CI,2307
+janito-0.15.0.dist-info/METADATA,sha256=9ZODZE5o2a45v78I2ptNveo8vAGr9l-_fK2d7ywkmaE,17212
+janito-0.15.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+janito-0.15.0.dist-info/entry_points.txt,sha256=JMbF_1jg-xQddidpAYkzjOKdw70fy_ymJfcmerY2wIY,47
+janito-0.15.0.dist-info/licenses/LICENSE,sha256=6-H8LXExbBIAuT4cyiE-Qy8Bad1K4pagQRVTWr6wkhk,1096
+janito-0.15.0.dist-info/RECORD,,