janito 0.14.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

janito-0.14.0.dist-info/METADATA

@@ -1,396 +0,0 @@
-Metadata-Version: 2.4
-Name: janito
-Version: 0.14.0
-Summary: Janito CLI tool
-Project-URL: Homepage, https://github.com/joaompinto/janito
-Author-email: João Pinto <lamego.pinto@gmail.com>
-License-File: LICENSE
-Requires-Python: >=3.8
-Requires-Dist: anthropic>=0.5.0
-Requires-Dist: beautifulsoup4>=4.13.0
-Requires-Dist: claudine>=0.1.0
-Requires-Dist: jinja2>=3.0.0
-Requires-Dist: lxml-html-clean>=0.4.1
-Requires-Dist: newspaper3k>=0.2.8
-Requires-Dist: requests>=2.32.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: trafilatura>=1.6.0
-Requires-Dist: typer>=0.9.0
-Description-Content-Type: text/markdown
-
-# 🤖 Janito
-
-Janito is a powerful AI-assisted command-line interface (CLI) tool built with Python, leveraging Anthropic's Claude for intelligent code and file management.
-
-[![GitHub Repository](https://img.shields.io/badge/GitHub-Repository-blue?logo=github)](https://github.com/joaompinto/janito)
-
-## ✨ Features
-
-- 🧠 Intelligent AI assistant powered by Claude
-- 📁 File management capabilities with real-time output
-- 🔍 Smart code search and editing
-- 💻 Interactive terminal interface with rich formatting
-- 📊 Detailed token usage tracking and cost reporting with cache savings analysis
-- 🌐 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
-- 💬 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
-
-- **Python 3.8+** - Janito requires Python 3.8 or higher
-- **Operating Systems**:
-  - Linux/macOS: Native support
-  - Windows: Requires Git Bash for proper operation of CLI tools
-- **Anthropic API Key** - Required for Claude AI integration
-
-## 🛠️ Installation
-
-```bash
-# Install directly from PyPI
-pip install janito
-```
-
-### Setting up your API Key
-
-Janito requires an Anthropic API key to function. You can:
-1. Set the API key: `janito --set-api-key your_api_key`
-
-For development or installation from source, please see [README_DEV.md](README_DEV.md).
-
-## 🚀 Usage Tutorial
-
-After installation, you can start using Janito right away. Let's walk through a simple tutorial:
-
-### Getting Started
-
-First, let's check that everything is working:
-
-```bash
-# Get help and see available commands
-janito --help
-```
-
-### Tutorial: Creating a Simple Project
-
-Let's create a simple HTML project with Janito's help:
-
-After installing Janito, using your prefered editor and/or terminal, go to a new empty folder.
-
-Use the janito command to create a new project.
-
-```bash
-# Step 1: Create a new project structure
-janito "Create a simple HTML page with a calculator and 3 columns with text for the 3 main activities of the Kazakh culture"
-```
-Browse the resulting html page.
-
-### Tutorial: Adding Features
-
-Now, let's enhance our example
-
-```bash
-# Step 2: Add multiplication and division features
-janito "Add some svg icons and remove the calculator"
-
-```
-
-Refresh the page
-
-### Exploring More Features
-
-Janito offers many more capabilities:
-
-```bash
-# Show detailed token usage and cost information
-janito --show-tokens "Explain what is in the project"
-
-# Use a specific parameter profile for creative tasks
-janito --profile creative "Write a fun description for our project"
-
-# Use trust mode for concise output without tool details
-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'
-
-# 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
-
-# You can press Ctrl+C at any time to interrupt a query
-# Interrupted conversations can be continued with --continue
-```
-
-## 🔧 Available Tools
-
-Janito comes with several built-in tools:
-- 📄 `str_replace_editor` - View, create, and edit files
-- 🔎 `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
-
-## 📊 Usage Tracking
-
-Janito includes a comprehensive token usage tracking system that helps you monitor API costs:
-
-- **Basic tracking**: By default, Janito displays a summary of token usage and cost after each query
-- **Detailed reporting**: Use the `--show-tokens` flag to see detailed breakdowns including:
-  - Input and output token counts
-  - Per-tool token usage statistics
-  - Precise cost calculations
-  - Cache performance metrics with savings analysis
-  - Line delta tracking for file modifications
-
-```bash
-# Show detailed token usage and cost information
-janito --show-tokens "Write a Python function to sort a list"
-
-# Basic usage (shows simplified token usage summary)
-janito "Explain Docker containers"
-
-# Use trust mode for concise output without tool details
-janito --trust "Create a simple Python script"
-# Or use the short alias
-janito -t "Create a simple Python script"
-```
-
-The usage tracker automatically calculates cache savings, showing you how much you're saving by reusing previous responses.
-
-## 📋 Parameter Profiles
-
-Janito offers predefined parameter profiles to optimize Claude's behavior for different tasks:
-
-- **precise**: Factual answers, documentation, structured data (temperature: 0.2)
-- **balanced**: Professional writing, summarization, everyday tasks (temperature: 0.5)
-- **conversational**: Natural dialogue, educational content (temperature: 0.7)
-- **creative**: Storytelling, brainstorming, marketing copy (temperature: 0.9)
-- **technical**: Code generation, debugging, technical problem-solving (temperature: 0.3)
-
-```bash
-# Use a specific profile
-janito --profile creative "Write a poem about coding"
-
-# View available profiles
-janito --show-config
-```
-
-## 🔇 Trust Mode
-
-Janito offers a trust mode that suppresses tool outputs for a more concise execution experience:
-
-### How It Works
-
-- When enabled with `--trust` or `-t`, Janito suppresses informational and success messages from tools
-- Only essential output and error messages are displayed
-- The final result from Claude is still shown in full
-- Trust mode is a per-session setting and not saved to your configuration
-
-### Using Trust Mode
-
-```bash
-# Enable trust mode with the full flag
-janito --trust "Create a Python script that reads a CSV file"
-
-# Or use the short alias
-janito -t "Create a Python script that reads a CSV file"
-```
-
-This feature is particularly useful for:
-- Experienced users who don't need to see every step of the process
-- Batch processing or scripting where concise output is preferred
-- 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 browse, manage, and continue previous discussions:
-
-### How It Works
-
-- Each conversation is saved with a unique message ID in `.janito/last_messages/`
-- 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
-# Continue the most recent conversation
-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:
-- Resume the most recent conversation when used without an ID
-- Resume a specific conversation when provided with a message ID
-- Maintain context across multiple interactions for complex tasks
-
-This feature is particularly useful for:
-- Multi-step development tasks
-- Iterative code improvements
-- Continuing discussions after system interruptions
-- Maintaining context when working on complex problems
-
-## ⚙️ Dependencies
-
-Janito automatically installs the following dependencies:
-- typer (>=0.9.0) - For CLI interface
-- rich (>=13.0.0) - For rich text formatting
-- claudine - For Claude AI integration
-- Additional packages for file handling and web content extraction
-
-## 🛠️ Command-Line Options
-
-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
---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)
---continue-id TEXT            Continue a specific conversation with the given ID
---history                     Show a summary of conversations. Use --history for default (20) or --history n to specify count
---help                        Show the help message and exit
-```
-
-## 🔑 API Key Configuration
-
-You can configure your Anthropic API key in several ways:
-
-```bash
-# Option 1: Set as environment variable
-export ANTHROPIC_API_KEY=your_api_key
-
-# Option 2: Configure globally within Janito
-janito --set-api-key your_api_key
-
-# Option 3: Let Janito prompt you on first use
-janito "Hello, I'm new to Janito!"
-```
-
-Your API key is securely stored and used for all future sessions.
-
-## 💻 Development
-
-For development instructions, please refer to [README_DEV.md](README_DEV.md).
-
-## 📜 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

janito-0.14.0.dist-info/RECORD

@@ -1,53 +0,0 @@
-janito/__init__.py,sha256=7oWOSdYGAlxA75CpzMThFPrXL2oWwJw60hTnRBxIo1A,53
-janito/__main__.py,sha256=Oy-Nc1tZkpyvTKuq1R8oHSuJTkvptN6H93kIHBu7DKY,107
-janito/callbacks.py,sha256=E1FPXYHZUgiEGMabYuf999PSf_Su4ByHOWlc1-hMqWE,915
-janito/config.py,sha256=XZYVjHPTv41l0NyGHaeq3UKB5FyRNHSEuLui-_mv5BU,13821
-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=QkH14BhnFQ2RgavLwxMKa9m_7C8KGoSuSjRNS3iYR1o,9477
-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=-7APIAk0gawVVrxd1AdeBwffEuudvy1bIhDE6LMXfw4,6583
-janito/cli/agent/query.py,sha256=Sly1k-cVOydTPraUmdSPKxFYrScmCOd8BfAqFUvWwkg,4612
-janito/cli/commands/__init__.py,sha256=4zGGB0x-TeBetSArBV38SZQo0T1K59vJofhXhLiD3g0,331
-janito/cli/commands/config.py,sha256=U1Bnc_YSMwFkX-1dcksmdgsoH2_yrO8MSYTaESxR-sQ,9819
-janito/cli/commands/history.py,sha256=WzWgPRZ7mQwlbDCPw3Hapb-K_Ybk1uKLs-qLams6sO4,5409
-janito/cli/commands/profile.py,sha256=jsGKSqXlaSLE__Xjj9OKNTW68evU0APyK9QYr_OEELQ,2397
-janito/cli/commands/validation.py,sha256=ldtfk0vAOkrto1Ys6G0MDmUOQvYalHsTd_l_0fMVHcI,718
-janito/cli/commands/workspace.py,sha256=nSCrN3SSK4zq10x38uksaOMuzx___rnl-cmyVpvNlqk,909
-janito/data/instructions_template.txt,sha256=Ewfjk_1qRO178WEcRQVONnff6CpRAeKGE8JAydD39Qw,2143
-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=FCs1ghalfHlXmcbAA_IlLcUll9hTOU1MMFGrTWopXvM,2741
-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=AFm0w_z-yyYRWxuR744OFpm5iCZaZpE-pWbnKbgajp4,3665
-janito/tools/bash/unix_persistent_bash.py,sha256=I59PPQiXHscPJ6Y7ev_83dLFNFWq1hKwAK9kFXdnbBY,7185
-janito/tools/bash/win_persistent_bash.py,sha256=96xm_yijjc6hBYfNluLahbvR2oUuHug_JkoMah7Hy38,12894
-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=k8F-n64bomHmDjavr5OJKC4cHhfm4_1-aMIFZdMICQo,6809
-janito/data/instructions_template.txt,sha256=Ewfjk_1qRO178WEcRQVONnff6CpRAeKGE8JAydD39Qw,2143
-janito-0.14.0.dist-info/METADATA,sha256=VzEC8lrwVeAhFxZDGripkjFcCm8CoHAjJFAh_OchFo0,14074
-janito-0.14.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-janito-0.14.0.dist-info/entry_points.txt,sha256=JMbF_1jg-xQddidpAYkzjOKdw70fy_ymJfcmerY2wIY,47
-janito-0.14.0.dist-info/licenses/LICENSE,sha256=6-H8LXExbBIAuT4cyiE-Qy8Bad1K4pagQRVTWr6wkhk,1096
-janito-0.14.0.dist-info/RECORD,,

janito-0.14.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-janito = janito.__main__:app