tunacode-cli 0.0.66__tar.gz → 0.0.68__tar.gz

tunacode_cli-0.0.68/.claude/scratchpad/archived/default_Fix_wizard_UI_-_branch_safety_interference_2025-08-20_222738_scratchpad.md

@@ -0,0 +1,9 @@
+# Fix wizard UI - branch safety interference
+_Started: 2025-08-20 22:22:27_
+_Agent: default
+
+[1] Found git_safety_setup.py - it prompts user to create safety branch (line 114)
+[2] GitSafetySetup registered in setup.py line 42, runs during wizard
+[3] Coordinator passes wizard_mode to steps that support it (line 49-52)
+[4] Creating fix: GitSafetySetup should skip prompt in wizard mode
+[5] Modified git_safety_setup.py execute() to accept wizard_mode and skip when True

tunacode_cli-0.0.68/.claude/scratchpad/archived/default_slash_command_system_implementation_2025-08-14_034024_scratchpad.md

@@ -0,0 +1,30 @@
+# slash_command_system_implementation
+_Started: 2025-08-14 01:56:07_
+_Agent: default
+
+[1] Analyzed existing command architecture - found CommandRegistry class with discover_commands() method and factory pattern
+[2] Found existing .claude/commands with example markdown files using YAML frontmatter and special syntax (!command, )
+[3] Located CommandRegistry initialization in repl.py - global variable with discover_commands method
+[4] Designing SlashCommandLoader architecture - will extend existing CommandRegistry.discover_commands to include markdown-based commands
+[5] Starting implementation design - creating SlashCommandLoader class and SlashCommand implementation
+[6] Examining existing template system to understand patterns - found TemplateLoader, Template class with shortcuts, and tool restrictions
+[7] Now designing the SlashCommand architecture - will use similar pattern to Template but for markdown-based commands with frontmatter parsing
+[8] Planning detailed implementation steps - creating slash command module structure and file organization
+[9] Defining data structures for SlashCommandMetadata, precedence handling, and command parsing
+[10] Designing template processor for , !command execution, @file inclusion, and YAML frontmatter parsing
+[11] Planning CommandRegistry integration - extending discover_commands method and help system updates
+[12] Completing comprehensive implementation plan - defining all components, test strategy, and rollout phases
+[13] Implementation plan complete - comprehensive slash command system designed with security, performance, and user experience considerations
+[14] Reviewing context injection implementation - checking if @file, @@glob, and !command patterns are fully specified
+[15] Enhanced context injection with size limits, circular inclusion detection, comprehensive tracking, and security validation
+[16] Continuing planning for remaining tasks: CommandRegistry integration, security validation, test suite, and documentation
+[17] Planning comprehensive security validation - command whitelisting, sandboxing, tool restrictions, and audit logging
+[18] Planning comprehensive test suite - unit tests, integration tests, security tests, performance tests, and fixtures
+[19] Planning comprehensive documentation - user guides, API docs, examples, migration guides, and troubleshooting
+[20] PLANNING COMPLETE - Comprehensive slash command system fully designed with all components, security, testing, and documentation
+[21] IMPLEMENTATION PHASE STARTED - Creating rollback point and beginning module structure creation
+[22] Created types.py with core data structures - CommandSource, SecurityLevel, SlashCommandMetadata, etc.
+[23] Implemented CommandValidator and MarkdownTemplateProcessor - need to fix import errors and add CommandContext type
+[24] Implemented all core slash command components - now fixing circular import issues in the module structure
+[25] Extended CommandRegistry with slash command discovery - now adding utility methods and completing integration
+[26] IMPLEMENTATION COMPLETE - All core components implemented and integrated with CommandRegistry

tunacode_cli-0.0.68/.claude/scratchpad/shared/done_tasks/default_Fix_wizard_UI_-_branch_safety_interference_2025-08-20_222738_scratchpad.md

@@ -0,0 +1,9 @@
+# Fix wizard UI - branch safety interference
+_Started: 2025-08-20 22:22:27_
+_Agent: default
+
+[1] Found git_safety_setup.py - it prompts user to create safety branch (line 114)
+[2] GitSafetySetup registered in setup.py line 42, runs during wizard
+[3] Coordinator passes wizard_mode to steps that support it (line 49-52)
+[4] Creating fix: GitSafetySetup should skip prompt in wizard mode
+[5] Modified git_safety_setup.py execute() to accept wizard_mode and skip when True

tunacode_cli-0.0.68/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased] - 2025-08-20
+
+### Added
+
+- **Comprehensive Onboarding Experience Improvements** (#88) - Thanks to **@ryumacodes**!
+  - Enhanced user onboarding flow and setup experience
+  - Improved first-time user guidance and documentation
+  - Streamlined installation and configuration process
+  - Resolved issue #55
+
+### Recent Pull Requests
+
+- **Slash Command System for Custom Automation Workflows** (#85) - Thanks to **@Lftobs**!
+  - Implemented flexible slash command infrastructure
+  - Enabled custom automation workflows
+  - Extended CLI capabilities with user-defined commands
+
+- **User Documentation and README Index** (#83) - Thanks to **@MclPio**!
+  - Added comprehensive user documentation
+  - Updated main README with organized index
+  - Improved documentation structure and accessibility
+
+### Contributors
+
+Special thanks to our recent contributors:
+- **@ryumacodes** - Onboarding improvements and multiple feature implementations
+- **@Lftobs** - Slash command system and workflow automation
+- **@MclPio** - Documentation improvements and organization

tunacode_cli-0.0.68/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: tunacode-cli
+Version: 0.0.68
+Summary: Your agentic CLI developer.
+Project-URL: Homepage, https://tunacode.xyz/
+Project-URL: Repository, https://github.com/alchemiststudiosDOTai/tunacode
+Project-URL: Issues, https://github.com/alchemiststudiosDOTai/tunacode/issues
+Project-URL: Documentation, https://github.com/alchemiststudiosDOTai/tunacode#readme
+Author-email: larock22 <noreply@github.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,automation,cli,development
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: <3.14,>=3.10
+Requires-Dist: click<8.2.0,>=8.0.0
+Requires-Dist: defusedxml
+Requires-Dist: prompt-toolkit==3.0.51
+Requires-Dist: pydantic-ai[logfire]==0.2.6
+Requires-Dist: pygments==2.19.1
+Requires-Dist: rich==14.0.0
+Requires-Dist: tiktoken>=0.5.2
+Requires-Dist: typer<0.10.0,>=0.9.0
+Provides-Extra: dev
+Requires-Dist: autoflake>=2.0.0; extra == 'dev'
+Requires-Dist: bandit; extra == 'dev'
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: dead>=1.5.0; extra == 'dev'
+Requires-Dist: hatch>=1.6.0; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: textual-dev; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Requires-Dist: unimport>=1.0.0; extra == 'dev'
+Requires-Dist: vulture>=2.7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# TunaCode CLI
+
+<div align="center">
+
+[![PyPI version](https://badge.fury.io/py/tunacode-cli.svg)](https://badge.fury.io/py/tunacode-cli)
+[![Downloads](https://pepy.tech/badge/tunacode-cli)](https://pepy.tech/project/tunacode-cli)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**AI-powered CLI coding assistant**
+
+![TunaCode Example](assets/tunacode_example.png)
+
+</div>
+
+---
+
+## Quick Install
+
+```bash
+# Option 1: One-line install (Linux/macOS)
+wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
+
+# Option 2: pip install
+pip install tunacode-cli
+```
+
+For detailed installation and configuration instructions, see the [**Getting Started Guide**](documentation/user/getting-started.md).
+
+## Development Installation
+
+For contributors and developers who want to work on TunaCode:
+
+```bash
+# Clone the repository
+git clone https://github.com/alchemiststudiosDOTai/tunacode.git
+cd tunacode
+
+# Quick setup (recommended)
+./scripts/setup_dev_env.sh
+
+# Or manual setup
+python3 -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install -e ".[dev]"
+
+# Verify installation
+python -m tunacode --version
+```
+
+See the [Hatch Build System Guide](documentation/development/hatch-build-system.md) for detailed instructions on the development environment.
+
+## Configuration
+
+Choose your AI provider and set your API key. For more details, see the [Configuration Section](documentation/user/getting-started.md#2-configuration) in the Getting Started Guide.
+
+### Recommended Models
+
+Based on extensive testing, these models provide the best performance:
+
+- `google/gemini-2.5-pro` - Excellent for complex reasoning
+- `openai/gpt-4.1` - Strong general-purpose model
+- `deepseek/deepseek-r1-0528` - Great for code generation
+- `openai/gpt-4.1-mini` - Fast and cost-effective
+- `anthropic/claude-4-sonnet-20250522` - Superior context handling
+
+_Note: Formal evaluations coming soon. Any model can work, but these have shown the best results in practice._
+
+## Start Coding
+
+```bash
+tunacode
+```
+
+## Basic Commands
+
+| Command                  | Description            |
+| ------------------------ | ---------------------- |
+| `/help`                  | Show all commands      |
+| `/model <provider:name>` | Switch model           |
+| `/clear`                 | Clear message history  |
+| `/compact`               | Summarize conversation |
+| `/branch <name>`         | Create Git branch      |
+| `/yolo`                  | Skip confirmations     |
+| `!<command>`             | Run shell command      |
+| `exit`                   | Exit TunaCode          |
+
+## Performance
+
+TunaCode leverages parallel execution for read-only operations, achieving **3x faster** file operations:
+
+![Parallel Execution Performance](docs/assets/parrelel_work_3x.png)
+
+Multiple file reads, directory listings, and searches execute concurrently using async I/O, making code exploration significantly faster.
+
+## Features in Development
+
+- **Bug Fixes**: Actively addressing issues - please report any bugs you encounter!
+
+_Note: While the tool is fully functional, we're focusing on stability and core features before optimizing for speed._
+
+## Safety First
+
+⚠️ **Important**: TunaCode can modify your codebase. Always:
+
+- Use Git branches before making changes
+- Review file modifications before confirming
+- Keep backups of important work
+
+## Documentation
+
+For a complete overview of the documentation, see the [**Documentation Hub**](documentation/README.md).
+
+### User Documentation
+
+- [**Getting Started**](documentation/user/getting-started.md) - How to install, configure, and use TunaCode.
+- [**Commands**](documentation/user/commands.md) - A complete list of all available commands.
+
+### Developer Documentation
+
+- **Architecture** (planned) - The overall architecture of the TunaCode application.
+- **Contributing** (planned) - Guidelines for contributing to the project.
+- **Tools** (planned) - How to create and use custom tools.
+- **Testing** (planned) - Information on the testing philosophy and how to run tests.
+
+### Guides
+
+- [**Advanced Configuration**](documentation/configuration/config-file-example.md) - An example of an advanced configuration file.
+
+### Reference
+
+- **Changelog** (planned) - A history of changes to the application.
+- **Roadmap** (planned) - The future direction of the project.
+- **Security** (planned) - Information about the security of the application.
+
+## Links
+
+- [PyPI Package](https://pypi.org/project/tunacode-cli/)
+- [GitHub Repository](https://github.com/alchemiststudiosDOTai/tunacode)
+- [Report Issues](https://github.com/alchemiststudiosDOTai/tunacode/issues)
+
+---
+
+MIT License - see [LICENSE](LICENSE) file

tunacode_cli-0.0.68/README.md

@@ -0,0 +1,144 @@
+# TunaCode CLI
+
+<div align="center">
+
+[![PyPI version](https://badge.fury.io/py/tunacode-cli.svg)](https://badge.fury.io/py/tunacode-cli)
+[![Downloads](https://pepy.tech/badge/tunacode-cli)](https://pepy.tech/project/tunacode-cli)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**AI-powered CLI coding assistant**
+
+![TunaCode Example](assets/tunacode_example.png)
+
+</div>
+
+---
+
+## Quick Install
+
+```bash
+# Option 1: One-line install (Linux/macOS)
+wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
+
+# Option 2: pip install
+pip install tunacode-cli
+```
+
+For detailed installation and configuration instructions, see the [**Getting Started Guide**](documentation/user/getting-started.md).
+
+## Development Installation
+
+For contributors and developers who want to work on TunaCode:
+
+```bash
+# Clone the repository
+git clone https://github.com/alchemiststudiosDOTai/tunacode.git
+cd tunacode
+
+# Quick setup (recommended)
+./scripts/setup_dev_env.sh
+
+# Or manual setup
+python3 -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install -e ".[dev]"
+
+# Verify installation
+python -m tunacode --version
+```
+
+See the [Hatch Build System Guide](documentation/development/hatch-build-system.md) for detailed instructions on the development environment.
+
+## Configuration
+
+Choose your AI provider and set your API key. For more details, see the [Configuration Section](documentation/user/getting-started.md#2-configuration) in the Getting Started Guide.
+
+### Recommended Models
+
+Based on extensive testing, these models provide the best performance:
+
+- `google/gemini-2.5-pro` - Excellent for complex reasoning
+- `openai/gpt-4.1` - Strong general-purpose model
+- `deepseek/deepseek-r1-0528` - Great for code generation
+- `openai/gpt-4.1-mini` - Fast and cost-effective
+- `anthropic/claude-4-sonnet-20250522` - Superior context handling
+
+_Note: Formal evaluations coming soon. Any model can work, but these have shown the best results in practice._
+
+## Start Coding
+
+```bash
+tunacode
+```
+
+## Basic Commands
+
+| Command                  | Description            |
+| ------------------------ | ---------------------- |
+| `/help`                  | Show all commands      |
+| `/model <provider:name>` | Switch model           |
+| `/clear`                 | Clear message history  |
+| `/compact`               | Summarize conversation |
+| `/branch <name>`         | Create Git branch      |
+| `/yolo`                  | Skip confirmations     |
+| `!<command>`             | Run shell command      |
+| `exit`                   | Exit TunaCode          |
+
+## Performance
+
+TunaCode leverages parallel execution for read-only operations, achieving **3x faster** file operations:
+
+![Parallel Execution Performance](docs/assets/parrelel_work_3x.png)
+
+Multiple file reads, directory listings, and searches execute concurrently using async I/O, making code exploration significantly faster.
+
+## Features in Development
+
+- **Bug Fixes**: Actively addressing issues - please report any bugs you encounter!
+
+_Note: While the tool is fully functional, we're focusing on stability and core features before optimizing for speed._
+
+## Safety First
+
+⚠️ **Important**: TunaCode can modify your codebase. Always:
+
+- Use Git branches before making changes
+- Review file modifications before confirming
+- Keep backups of important work
+
+## Documentation
+
+For a complete overview of the documentation, see the [**Documentation Hub**](documentation/README.md).
+
+### User Documentation
+
+- [**Getting Started**](documentation/user/getting-started.md) - How to install, configure, and use TunaCode.
+- [**Commands**](documentation/user/commands.md) - A complete list of all available commands.
+
+### Developer Documentation
+
+- **Architecture** (planned) - The overall architecture of the TunaCode application.
+- **Contributing** (planned) - Guidelines for contributing to the project.
+- **Tools** (planned) - How to create and use custom tools.
+- **Testing** (planned) - Information on the testing philosophy and how to run tests.
+
+### Guides
+
+- [**Advanced Configuration**](documentation/configuration/config-file-example.md) - An example of an advanced configuration file.
+
+### Reference
+
+- **Changelog** (planned) - A history of changes to the application.
+- **Roadmap** (planned) - The future direction of the project.
+- **Security** (planned) - Information about the security of the application.
+
+## Links
+
+- [PyPI Package](https://pypi.org/project/tunacode-cli/)
+- [GitHub Repository](https://github.com/alchemiststudiosDOTai/tunacode)
+- [Report Issues](https://github.com/alchemiststudiosDOTai/tunacode/issues)
+
+---
+
+MIT License - see [LICENSE](LICENSE) file

tunacode_cli-0.0.68/TUNACODE.md

@@ -0,0 +1,73 @@
+### Workflow
+
+- **CRITICAL: WORKTREE REQUIREMENT** - When user requests a worktree, you MUST:
+  1. Create the worktree with `git worktree add -b branch-name ../dirname`
+  2. If access is blocked, immediately ask: "I cannot access the worktree directory. Should I: a) Work in a subdirectory instead, b) Use a branch in the main directory, or c) Another solution?"
+  3. NEVER proceed without a worktree if user specifically requested one
+
+- before any updates make a git commit rollback point, clearly labeled for future agents
+
+- the clear outline of the objective MUST be established before we begin ANY coding, do not under any circumstance begin any updates untill this is clearly understood, if you have any ambiuguity or quesiton, the user can be brought in or use best practises
+
+- use scratchpad-multi.sh as you work, after the MD file is done being used sort it to the approate directory
+- To use `llm-agent-tools/scratchpad-multi.sh`, start a task with `./llm-agent-tools/scratchpad-multi.sh --agent <name> start "Task Title"` and record updates using `step`, `revise <N>`, and `branch <N>`. When complete, run `finish` to interactively archive the scratchpad to `documentation/` and/or `.claude/` (a backup is stored under `.claude/scratchpad/shared/done_tasks/`).
+
+- the MD file created by the bash file MUST be used for the duiration of the task you will be PUNISHED if you do not update this file as you work.
+
+- any key logic or file's must be inlcuded here in the following format if this format is not followed you will STOP reasses, and begin again
+
+- pre-commit hooks can NOT be skipped, you will be punished for skipping the,
+
+```
+# Implementing Authentication Module
+_Started: 2025-08-06 10:00:00_
+_Agent: default_
+
+[1] Found auth logic in src/auth/handler.py:45
+[2] Key dependencies: jwt, bcrypt, session_manager
+[3] Modified login function to add rate limiting
+[3~1] Fixed edge case for empty passwords
+```
+
+- General documentation → archive to @documentation/
+- Developer/tunacode-specific → archive to @ .claude
+- Organize archives by category (agent/development/ etc)
+- In general the scratchpad should never go in any other dirs ececpt the two above
+
+- if a task at hand is to big to handle as a one off use the taskmaster MCP but in general this should only be used as needed, usually it will not be needed
+
+- grep documentation and .claude as needed BOTH of these have a README.md that ahs a direcoty map, you MUST read these before any bigger grep or context searches
+
+- in general gather as much context as needed, unless specified by the user
+
+- this is the most important part of this prompt: Synthesis context aggressively and heuristically AS NEEDED ONLY You can deploy the appropriate subagent for complex tasks agents list below
+
+### Documentation
+
+- update the documents @documentation and in .claude after any update.
+
+- use the subagent tech-docs-maintainer to update the documentation you MUST instruct the subagent to keep doc updates short you will be PUNISHED for not telling the documentation agent to keep it to only the most distilled information
+
+- always follow best practices with git commits naming and gh cli workflows
+
+- commit frequently
+
+- always be on the side of safety, if you have any question consult the user
+
+### Python Coding Standards
+
+- always use the venv
+- Use type hints (PEP 484) for all function signatures
+- Prefer f-strings (PEP 498) over %-formatting or .format()
+- Use pathlib.Path instead of os.path for filesystem operations
+- Structure imports: stdlib → third-party → local (PEP 8)
+- Use dataclasses (PEP 557) for simple data containers
+- Prefer context managers (with) for resource handling
+- Use structural pattern matching (PEP 634) for complex
+- run ruff frequently
+
+### Testing
+
+- "hatch run test" command the entire testing suite
+
+- anytime a new feature or refactor is done, we MUST find or make the golden/character test FIRST as a baseline standaard BEFORE starting, under no circumstance are you to not follow this pattern

{tunacode_cli-0.0.66 → tunacode_cli-0.0.68}/documentation/README.md

@@ -13,11 +13,17 @@ documentation/
 ├── configuration/         # System configuration docs
 │   ├── config-file-example.md
 │   └── logging-configuration.md
-└── development/          # Development practices
-    ├── codebase-hygiene.md
-    ├── hatch-build-system.md
-    ├── performance-optimizations.md
-    └── prompt-principles.md
+├── development/          # Development practices
+│   ├── codebase-hygiene.md
+│   ├── command-system-architecture.md
+│   ├── creating-custom-commands.md
+│   ├── hatch-build-system.md
+|   ├── performance-optimizations.md
+│   └── prompt-principles.md
+│── user/                 # user guides
+    │── getting-started.md
+    │── commands.md
+    │── tools.md
 ```
 
 ## Purpose
@@ -26,6 +32,8 @@ General project documentation for features, architecture, and best practices.
 
 ## Quick Links
 
+- [Command System Architecture](development/command-system-architecture.md) - Technical overview of the command system design and components.
+- [Creating Custom Commands](development/creating-custom-commands.md) - Step-by-step guide for creating built-in and slash commands.
 - [Hatch Build System](development/hatch-build-system.md) - Complete guide to using Hatch for development and building.
 - [Configuration File Example](configuration/config-file-example.md) - Complete example of `~/.config/tunacode.json` with all available settings.
 - [Performance Optimizations](development/performance-optimizations.md) - Major performance improvements and optimization strategies.