tunacode-cli 0.0.67__py3-none-any.whl → 0.0.68__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of tunacode-cli might be problematic. Click here for more details.
- tunacode/cli/commands/__init__.py +2 -0
- tunacode/cli/commands/implementations/__init__.py +2 -0
- tunacode/cli/commands/implementations/command_reload.py +48 -0
- tunacode/cli/commands/implementations/quickstart.py +43 -0
- tunacode/cli/commands/registry.py +131 -1
- tunacode/cli/commands/slash/__init__.py +32 -0
- tunacode/cli/commands/slash/command.py +157 -0
- tunacode/cli/commands/slash/loader.py +134 -0
- tunacode/cli/commands/slash/processor.py +294 -0
- tunacode/cli/commands/slash/types.py +93 -0
- tunacode/cli/commands/slash/validator.py +399 -0
- tunacode/cli/main.py +4 -1
- tunacode/cli/repl.py +25 -0
- tunacode/configuration/defaults.py +1 -0
- tunacode/constants.py +1 -1
- tunacode/core/agents/agent_components/agent_helpers.py +14 -13
- tunacode/core/agents/main.py +1 -1
- tunacode/core/agents/utils.py +4 -3
- tunacode/core/setup/config_setup.py +231 -6
- tunacode/core/setup/coordinator.py +13 -5
- tunacode/core/setup/git_safety_setup.py +5 -1
- tunacode/exceptions.py +119 -5
- tunacode/setup.py +5 -2
- tunacode/tools/glob.py +9 -46
- tunacode/tools/grep.py +9 -51
- tunacode/tools/xml_helper.py +83 -0
- tunacode/tutorial/__init__.py +9 -0
- tunacode/tutorial/content.py +98 -0
- tunacode/tutorial/manager.py +182 -0
- tunacode/tutorial/steps.py +124 -0
- tunacode/ui/output.py +1 -1
- tunacode/utils/user_configuration.py +45 -0
- tunacode_cli-0.0.68.dist-info/METADATA +192 -0
- {tunacode_cli-0.0.67.dist-info → tunacode_cli-0.0.68.dist-info}/RECORD +37 -24
- tunacode_cli-0.0.67.dist-info/METADATA +0 -327
- {tunacode_cli-0.0.67.dist-info → tunacode_cli-0.0.68.dist-info}/WHEEL +0 -0
- {tunacode_cli-0.0.67.dist-info → tunacode_cli-0.0.68.dist-info}/entry_points.txt +0 -0
- {tunacode_cli-0.0.67.dist-info → tunacode_cli-0.0.68.dist-info}/licenses/LICENSE +0 -0
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: tunacode-cli
|
|
3
|
+
Version: 0.0.68
|
|
4
|
+
Summary: Your agentic CLI developer.
|
|
5
|
+
Project-URL: Homepage, https://tunacode.xyz/
|
|
6
|
+
Project-URL: Repository, https://github.com/alchemiststudiosDOTai/tunacode
|
|
7
|
+
Project-URL: Issues, https://github.com/alchemiststudiosDOTai/tunacode/issues
|
|
8
|
+
Project-URL: Documentation, https://github.com/alchemiststudiosDOTai/tunacode#readme
|
|
9
|
+
Author-email: larock22 <noreply@github.com>
|
|
10
|
+
License: MIT
|
|
11
|
+
License-File: LICENSE
|
|
12
|
+
Keywords: agent,automation,cli,development
|
|
13
|
+
Classifier: Development Status :: 4 - Beta
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
+
Classifier: Topic :: Software Development
|
|
21
|
+
Classifier: Topic :: Utilities
|
|
22
|
+
Requires-Python: <3.14,>=3.10
|
|
23
|
+
Requires-Dist: click<8.2.0,>=8.0.0
|
|
24
|
+
Requires-Dist: defusedxml
|
|
25
|
+
Requires-Dist: prompt-toolkit==3.0.51
|
|
26
|
+
Requires-Dist: pydantic-ai[logfire]==0.2.6
|
|
27
|
+
Requires-Dist: pygments==2.19.1
|
|
28
|
+
Requires-Dist: rich==14.0.0
|
|
29
|
+
Requires-Dist: tiktoken>=0.5.2
|
|
30
|
+
Requires-Dist: typer<0.10.0,>=0.9.0
|
|
31
|
+
Provides-Extra: dev
|
|
32
|
+
Requires-Dist: autoflake>=2.0.0; extra == 'dev'
|
|
33
|
+
Requires-Dist: bandit; extra == 'dev'
|
|
34
|
+
Requires-Dist: build; extra == 'dev'
|
|
35
|
+
Requires-Dist: dead>=1.5.0; extra == 'dev'
|
|
36
|
+
Requires-Dist: hatch>=1.6.0; extra == 'dev'
|
|
37
|
+
Requires-Dist: mypy; extra == 'dev'
|
|
38
|
+
Requires-Dist: pre-commit; extra == 'dev'
|
|
39
|
+
Requires-Dist: pytest; extra == 'dev'
|
|
40
|
+
Requires-Dist: pytest-asyncio; extra == 'dev'
|
|
41
|
+
Requires-Dist: pytest-cov; extra == 'dev'
|
|
42
|
+
Requires-Dist: ruff; extra == 'dev'
|
|
43
|
+
Requires-Dist: textual-dev; extra == 'dev'
|
|
44
|
+
Requires-Dist: twine; extra == 'dev'
|
|
45
|
+
Requires-Dist: unimport>=1.0.0; extra == 'dev'
|
|
46
|
+
Requires-Dist: vulture>=2.7; extra == 'dev'
|
|
47
|
+
Description-Content-Type: text/markdown
|
|
48
|
+
|
|
49
|
+
# TunaCode CLI
|
|
50
|
+
|
|
51
|
+
<div align="center">
|
|
52
|
+
|
|
53
|
+
[](https://badge.fury.io/py/tunacode-cli)
|
|
54
|
+
[](https://pepy.tech/project/tunacode-cli)
|
|
55
|
+
[](https://www.python.org/downloads/)
|
|
56
|
+
[](https://opensource.org/licenses/MIT)
|
|
57
|
+
|
|
58
|
+
**AI-powered CLI coding assistant**
|
|
59
|
+
|
|
60
|
+

|
|
61
|
+
|
|
62
|
+
</div>
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Quick Install
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
# Option 1: One-line install (Linux/macOS)
|
|
70
|
+
wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
|
|
71
|
+
|
|
72
|
+
# Option 2: pip install
|
|
73
|
+
pip install tunacode-cli
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
For detailed installation and configuration instructions, see the [**Getting Started Guide**](documentation/user/getting-started.md).
|
|
77
|
+
|
|
78
|
+
## Development Installation
|
|
79
|
+
|
|
80
|
+
For contributors and developers who want to work on TunaCode:
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
# Clone the repository
|
|
84
|
+
git clone https://github.com/alchemiststudiosDOTai/tunacode.git
|
|
85
|
+
cd tunacode
|
|
86
|
+
|
|
87
|
+
# Quick setup (recommended)
|
|
88
|
+
./scripts/setup_dev_env.sh
|
|
89
|
+
|
|
90
|
+
# Or manual setup
|
|
91
|
+
python3 -m venv venv
|
|
92
|
+
source venv/bin/activate # On Windows: venv\Scripts\activate
|
|
93
|
+
pip install -e ".[dev]"
|
|
94
|
+
|
|
95
|
+
# Verify installation
|
|
96
|
+
python -m tunacode --version
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
See the [Hatch Build System Guide](documentation/development/hatch-build-system.md) for detailed instructions on the development environment.
|
|
100
|
+
|
|
101
|
+
## Configuration
|
|
102
|
+
|
|
103
|
+
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.
|
|
104
|
+
|
|
105
|
+
### Recommended Models
|
|
106
|
+
|
|
107
|
+
Based on extensive testing, these models provide the best performance:
|
|
108
|
+
|
|
109
|
+
- `google/gemini-2.5-pro` - Excellent for complex reasoning
|
|
110
|
+
- `openai/gpt-4.1` - Strong general-purpose model
|
|
111
|
+
- `deepseek/deepseek-r1-0528` - Great for code generation
|
|
112
|
+
- `openai/gpt-4.1-mini` - Fast and cost-effective
|
|
113
|
+
- `anthropic/claude-4-sonnet-20250522` - Superior context handling
|
|
114
|
+
|
|
115
|
+
_Note: Formal evaluations coming soon. Any model can work, but these have shown the best results in practice._
|
|
116
|
+
|
|
117
|
+
## Start Coding
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
tunacode
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
## Basic Commands
|
|
124
|
+
|
|
125
|
+
| Command | Description |
|
|
126
|
+
| ------------------------ | ---------------------- |
|
|
127
|
+
| `/help` | Show all commands |
|
|
128
|
+
| `/model <provider:name>` | Switch model |
|
|
129
|
+
| `/clear` | Clear message history |
|
|
130
|
+
| `/compact` | Summarize conversation |
|
|
131
|
+
| `/branch <name>` | Create Git branch |
|
|
132
|
+
| `/yolo` | Skip confirmations |
|
|
133
|
+
| `!<command>` | Run shell command |
|
|
134
|
+
| `exit` | Exit TunaCode |
|
|
135
|
+
|
|
136
|
+
## Performance
|
|
137
|
+
|
|
138
|
+
TunaCode leverages parallel execution for read-only operations, achieving **3x faster** file operations:
|
|
139
|
+
|
|
140
|
+

|
|
141
|
+
|
|
142
|
+
Multiple file reads, directory listings, and searches execute concurrently using async I/O, making code exploration significantly faster.
|
|
143
|
+
|
|
144
|
+
## Features in Development
|
|
145
|
+
|
|
146
|
+
- **Bug Fixes**: Actively addressing issues - please report any bugs you encounter!
|
|
147
|
+
|
|
148
|
+
_Note: While the tool is fully functional, we're focusing on stability and core features before optimizing for speed._
|
|
149
|
+
|
|
150
|
+
## Safety First
|
|
151
|
+
|
|
152
|
+
⚠️ **Important**: TunaCode can modify your codebase. Always:
|
|
153
|
+
|
|
154
|
+
- Use Git branches before making changes
|
|
155
|
+
- Review file modifications before confirming
|
|
156
|
+
- Keep backups of important work
|
|
157
|
+
|
|
158
|
+
## Documentation
|
|
159
|
+
|
|
160
|
+
For a complete overview of the documentation, see the [**Documentation Hub**](documentation/README.md).
|
|
161
|
+
|
|
162
|
+
### User Documentation
|
|
163
|
+
|
|
164
|
+
- [**Getting Started**](documentation/user/getting-started.md) - How to install, configure, and use TunaCode.
|
|
165
|
+
- [**Commands**](documentation/user/commands.md) - A complete list of all available commands.
|
|
166
|
+
|
|
167
|
+
### Developer Documentation
|
|
168
|
+
|
|
169
|
+
- **Architecture** (planned) - The overall architecture of the TunaCode application.
|
|
170
|
+
- **Contributing** (planned) - Guidelines for contributing to the project.
|
|
171
|
+
- **Tools** (planned) - How to create and use custom tools.
|
|
172
|
+
- **Testing** (planned) - Information on the testing philosophy and how to run tests.
|
|
173
|
+
|
|
174
|
+
### Guides
|
|
175
|
+
|
|
176
|
+
- [**Advanced Configuration**](documentation/configuration/config-file-example.md) - An example of an advanced configuration file.
|
|
177
|
+
|
|
178
|
+
### Reference
|
|
179
|
+
|
|
180
|
+
- **Changelog** (planned) - A history of changes to the application.
|
|
181
|
+
- **Roadmap** (planned) - The future direction of the project.
|
|
182
|
+
- **Security** (planned) - Information about the security of the application.
|
|
183
|
+
|
|
184
|
+
## Links
|
|
185
|
+
|
|
186
|
+
- [PyPI Package](https://pypi.org/project/tunacode-cli/)
|
|
187
|
+
- [GitHub Repository](https://github.com/alchemiststudiosDOTai/tunacode)
|
|
188
|
+
- [Report Issues](https://github.com/alchemiststudiosDOTai/tunacode/issues)
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
MIT License - see [LICENSE](LICENSE) file
|
|
@@ -1,33 +1,41 @@
|
|
|
1
1
|
tunacode/__init__.py,sha256=yUul8igNYMfUrHnYfioIGAqvrH8b5BKiO_pt1wVnmd0,119
|
|
2
|
-
tunacode/constants.py,sha256=
|
|
2
|
+
tunacode/constants.py,sha256=cmzNEK6uOL8FF9Zll_OUclyBkxHVN5CZAMCvklRFtWk,6100
|
|
3
3
|
tunacode/context.py,sha256=YtfRjUiqsSkk2k9Nn_pjb_m-AXyh6XcOBOJWtFI0wVw,2405
|
|
4
|
-
tunacode/exceptions.py,sha256=
|
|
4
|
+
tunacode/exceptions.py,sha256=m80njR-LqBXhFAEOPqCE7N2QPU4Fkjlf_f6CWKO0_Is,8479
|
|
5
5
|
tunacode/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
6
|
-
tunacode/setup.py,sha256=
|
|
6
|
+
tunacode/setup.py,sha256=F1E4zHVnbByu_Uo6AhCJ-W-lIGF_gV6kB84HLAGLmVY,2103
|
|
7
7
|
tunacode/types.py,sha256=Q3PeHB01qeaKteGDQf8Byx4q1XLSXVnNDG6D-WjWsBk,10157
|
|
8
8
|
tunacode/cli/__init__.py,sha256=zgs0UbAck8hfvhYsWhWOfBe5oK09ug2De1r4RuQZREA,55
|
|
9
|
-
tunacode/cli/main.py,sha256=
|
|
10
|
-
tunacode/cli/repl.py,sha256=
|
|
11
|
-
tunacode/cli/commands/__init__.py,sha256=
|
|
9
|
+
tunacode/cli/main.py,sha256=H4g9ilS2KmCP37lQuIOIcSG2NGGXXgj-lUU6MdfLrmI,3127
|
|
10
|
+
tunacode/cli/repl.py,sha256=jhKMAff4kxt5f2ONacPao2wgcZvNr2BRBZdITh5yDro,22480
|
|
11
|
+
tunacode/cli/commands/__init__.py,sha256=J7MZofTaSgspAKP64OavPukj4l53qvkv_-sCfYEUi10,1794
|
|
12
12
|
tunacode/cli/commands/base.py,sha256=Ge_lNQA-GDfcb1Ap1oznCH3UrifBiHH3bA9DNL-tCDw,2519
|
|
13
|
-
tunacode/cli/commands/registry.py,sha256=
|
|
13
|
+
tunacode/cli/commands/registry.py,sha256=oAppbaOb-2blVo7Akthu6dbR9UFvXom6wf8m52qftpU,14962
|
|
14
14
|
tunacode/cli/commands/template_shortcut.py,sha256=ApYTPkDVBRaLxa7rWaPrsGcJdkR7eg09k18KyTjYg_E,3447
|
|
15
|
-
tunacode/cli/commands/implementations/__init__.py,sha256=
|
|
15
|
+
tunacode/cli/commands/implementations/__init__.py,sha256=dFczjIqCJTPrsSycD6PZYnp5_cIEQEGgKr0Y14MRGjs,1088
|
|
16
|
+
tunacode/cli/commands/implementations/command_reload.py,sha256=GyjeKvJbgE4VYkaasGajspdk9wffumZMNLzfCUeNazM,1555
|
|
16
17
|
tunacode/cli/commands/implementations/conversation.py,sha256=ZijCNaRi1p5v1Q-IaVHtU2_BripSW3JCVKTtqFkOUjg,4676
|
|
17
18
|
tunacode/cli/commands/implementations/debug.py,sha256=ornvceGF4GbJd2OJXnnT9i9KpHBAMJUYNs9wNhzViGM,6764
|
|
18
19
|
tunacode/cli/commands/implementations/development.py,sha256=I8jHgYY3VgjTU8its0D0ysruuVqKbNTBur0JjPIUIZA,2844
|
|
19
20
|
tunacode/cli/commands/implementations/model.py,sha256=uthx6IX9KwgwywNTDklkJpqCbaTX9h1_p-eVmqL73WQ,2245
|
|
20
21
|
tunacode/cli/commands/implementations/plan.py,sha256=iZtvdGPqvGqMr8_lYil8_8NOL1iyc54Bxtb0gb9VOnw,1825
|
|
22
|
+
tunacode/cli/commands/implementations/quickstart.py,sha256=53H7ubYMGMgmCeYCs6o_F91Q4pd3Ky008lCU4GPuRP8,1363
|
|
21
23
|
tunacode/cli/commands/implementations/system.py,sha256=2bTbJsiniac11XjGWZU4Cd6Cpug9C2-HtlmLFCgK20I,12009
|
|
22
24
|
tunacode/cli/commands/implementations/template.py,sha256=YeFOjbKKfPswPCHPvlDUwXvg6J0MesyAyVsujiIgPbU,5482
|
|
23
25
|
tunacode/cli/commands/implementations/todo.py,sha256=Dtz5bgcuK2VXGPWEBBZQgnWUMYkRXNzTGf_qkVPLF2U,8125
|
|
26
|
+
tunacode/cli/commands/slash/__init__.py,sha256=O5EiITHZJgzIciKA_nylj5PyOZNvXE9jPmOHioDk3cU,824
|
|
27
|
+
tunacode/cli/commands/slash/command.py,sha256=ewtyLJNAW0cJLwpSiycyVH0LpqsR3xVqCBhSym7d_7w,6329
|
|
28
|
+
tunacode/cli/commands/slash/loader.py,sha256=j2gQK4WTttW8GMvSWusrY7s3LYx5Gro_9t4j6vxFwDU,5616
|
|
29
|
+
tunacode/cli/commands/slash/processor.py,sha256=JQ_sE9Vu7LAdSnUmMz-hBPfD8E60aIHPNeaFMn7PQjM,11751
|
|
30
|
+
tunacode/cli/commands/slash/types.py,sha256=v52tDX7T5I3nEETakloXLQzJqWXSyxcM1K5FbFNdtzw,2375
|
|
31
|
+
tunacode/cli/commands/slash/validator.py,sha256=NF6u4n_VFoNiBRlErzNRA1iTG11bScizil3PhzpRSb4,13949
|
|
24
32
|
tunacode/cli/repl_components/__init__.py,sha256=5ZjPJ3yUvZ5x6Vg9EYJ03-tdxfEEdmfradCmwSlVY3E,334
|
|
25
33
|
tunacode/cli/repl_components/command_parser.py,sha256=BU_3h4aJ4MNQ0UU6_ulvK7NRTlC417soZkGGzMFy6-s,2368
|
|
26
34
|
tunacode/cli/repl_components/error_recovery.py,sha256=59DCv8PkWg3ZOjaNPkWmYw0u68JpPMIxUMikMiW4TjY,6176
|
|
27
35
|
tunacode/cli/repl_components/output_display.py,sha256=uzse2bhxSyCWnJD0Ni5lwnp0BmYDAr1tZbnlj3-x6ro,1484
|
|
28
36
|
tunacode/cli/repl_components/tool_executor.py,sha256=i6KB_qXaFlbdv90_3xj3TwL6alFd_JAbSS0Cdln9zfU,3767
|
|
29
37
|
tunacode/configuration/__init__.py,sha256=MbVXy8bGu0yKehzgdgZ_mfWlYGvIdb1dY2Ly75nfuPE,17
|
|
30
|
-
tunacode/configuration/defaults.py,sha256=
|
|
38
|
+
tunacode/configuration/defaults.py,sha256=_nT5d9Mi80SiVnWBcDCI3VoB8L5CoGmvnzWlM4k2ECY,1341
|
|
31
39
|
tunacode/configuration/models.py,sha256=buH8ZquvcYI3OQBDIZeJ08cu00rSCeNABtUwl3VQS0E,4103
|
|
32
40
|
tunacode/configuration/settings.py,sha256=9wtIWBlLhW_ZBlLx-GA4XDfVZyGj2Gs6Zk49vk-nHq0,1047
|
|
33
41
|
tunacode/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
@@ -35,11 +43,11 @@ tunacode/core/code_index.py,sha256=2qxEn2eTIegV4F_gLeZO5lAOv8mkf4Y_t21whZ9F2Fk,1
|
|
|
35
43
|
tunacode/core/state.py,sha256=aksE0mM2xG-1CkLmpi8cu1n1SOMfqpMuqMBciEVShf0,7893
|
|
36
44
|
tunacode/core/tool_handler.py,sha256=42yUfnq5jgk-0LK93JoJgtsXfVDTf-7hNXyKEfH2FM0,3626
|
|
37
45
|
tunacode/core/agents/__init__.py,sha256=UUJiPYb91arwziSpjd7vIk7XNGA_4HQbsOIbskSqevA,149
|
|
38
|
-
tunacode/core/agents/main.py,sha256=
|
|
39
|
-
tunacode/core/agents/utils.py,sha256=
|
|
46
|
+
tunacode/core/agents/main.py,sha256=8K5f_-gXm3VyAMM8FqH2ucZBjKnVJ8kcqEpov-5qk-c,18244
|
|
47
|
+
tunacode/core/agents/utils.py,sha256=ja6Dwq3AVX6QTddmG2uY5ENxFxr5uzc4TS9OjommXp0,14535
|
|
40
48
|
tunacode/core/agents/agent_components/__init__.py,sha256=CL4XH47T6v_iYy7xCPYjyiEFNOFnkcKwbTuKw6IjKTs,1474
|
|
41
49
|
tunacode/core/agents/agent_components/agent_config.py,sha256=lkq6-6p8AHVZuoebUrFXtZgmBJipK8CSD2JaBA0Am_A,11845
|
|
42
|
-
tunacode/core/agents/agent_components/agent_helpers.py,sha256
|
|
50
|
+
tunacode/core/agents/agent_components/agent_helpers.py,sha256=-jeihh0oWZ4VZ81GUhpYFQ2v8EGw9j9WU81swUjTAvk,8276
|
|
43
51
|
tunacode/core/agents/agent_components/json_tool_parser.py,sha256=HuyNT0rs-ppx_gLAI2e0XMVGbR_F0WXZfP3sx38VoMg,3447
|
|
44
52
|
tunacode/core/agents/agent_components/message_handler.py,sha256=KJGOtb9VhumgZpxxwO45HrKLhU9_MwuoWRsSQwJviNU,3704
|
|
45
53
|
tunacode/core/agents/agent_components/node_processor.py,sha256=BAVbXy17sfW3i4LCTdJ9_MSNc7j6qz1bP3_6IhprIW4,20912
|
|
@@ -60,10 +68,10 @@ tunacode/core/logging/logger.py,sha256=9RjRuX0GoUojRJ8WnJGQPFdXiluiJMCoFmvc8xEio
|
|
|
60
68
|
tunacode/core/setup/__init__.py,sha256=seoWYpRonptxNyApapS-yGz4o3jTj8vLsRPCTUO4siM,439
|
|
61
69
|
tunacode/core/setup/agent_setup.py,sha256=tpOIW85C6o1m8pwAZQBIMKxKIyBUOpHHn4JJmDBFH3Q,1403
|
|
62
70
|
tunacode/core/setup/base.py,sha256=FMjBQQS_q3KOxHqfg7NJGmKq-1nxC40htiPZprzTu7I,970
|
|
63
|
-
tunacode/core/setup/config_setup.py,sha256=
|
|
64
|
-
tunacode/core/setup/coordinator.py,sha256=
|
|
71
|
+
tunacode/core/setup/config_setup.py,sha256=DhP23S18ILD2AnGYGPe7-M8QRZDiLncf8zjp51sxk4A,24254
|
|
72
|
+
tunacode/core/setup/coordinator.py,sha256=5ZhD4rHUrW0RIdGnjmoK4wCvqlNGcXal4Qwev4s039U,2393
|
|
65
73
|
tunacode/core/setup/environment_setup.py,sha256=n3IrObKEynHZSwtUJ1FddMg2C4sHz7ca42awemImV8s,2225
|
|
66
|
-
tunacode/core/setup/git_safety_setup.py,sha256=
|
|
74
|
+
tunacode/core/setup/git_safety_setup.py,sha256=Htt8A4BAn7F4DbjhNu_SO01zjwaRQ3wMv-vZujE1-JA,7328
|
|
67
75
|
tunacode/core/setup/template_setup.py,sha256=0lDGhNVCvGN7ykqHnl3pj4CONH3I2PvMzkmIZibfSoc,2640
|
|
68
76
|
tunacode/core/token_usage/api_response_parser.py,sha256=plLltHg4zGVzxjv3MFj45bbd-NOJeT_v3P0Ki4zlvn4,1831
|
|
69
77
|
tunacode/core/token_usage/cost_calculator.py,sha256=RjO-O0JENBuGOrWP7QgBZlZxeXC-PAIr8tj_9p_BxOU,2058
|
|
@@ -78,8 +86,8 @@ tunacode/tools/__init__.py,sha256=ECBuUWWF1JjHW42CCceaPKgVTQyuljbz3RlhuA2fe2s,31
|
|
|
78
86
|
tunacode/tools/base.py,sha256=jQz_rz2rNZrKo2vZtyArwiHCMdAaqRYJGYtSZ27nxcU,10711
|
|
79
87
|
tunacode/tools/bash.py,sha256=fEjI5Vm7yqQiOzc83kFzu1n4zAPiWLQNHZYY-ORNV4Q,12437
|
|
80
88
|
tunacode/tools/exit_plan_mode.py,sha256=DOl_8CsY7h9N-SuCg2YgMjp8eEMuO5I8Tv8XjoJcTJ0,10597
|
|
81
|
-
tunacode/tools/glob.py,sha256=
|
|
82
|
-
tunacode/tools/grep.py,sha256=
|
|
89
|
+
tunacode/tools/glob.py,sha256=_uAMV5cloRP0AQMbm7h_bKeqfhe7KFoBx9gfYls5ZzE,22956
|
|
90
|
+
tunacode/tools/grep.py,sha256=nKKpJjr2uupErB2KAUgTog3ZqC8oKiho5qkKeFvpY70,22178
|
|
83
91
|
tunacode/tools/list_dir.py,sha256=aJ2FdAUU-HxOmAwBk188KYIYB94thESIrSBflzoUlYs,12402
|
|
84
92
|
tunacode/tools/present_plan.py,sha256=PjpZ7Ll9T6Ij-oBNPK9iysvGJZpvKr1-lqBpURNXiLM,10856
|
|
85
93
|
tunacode/tools/read_file.py,sha256=Xy8vkckjq8kBNNYJMpMhq0pabVi4Kp8b57C3C3picI4,6729
|
|
@@ -88,6 +96,7 @@ tunacode/tools/schema_assembler.py,sha256=sUePWvprfTHz9hau1q7hmWd12ew3rHdbASAGkp
|
|
|
88
96
|
tunacode/tools/todo.py,sha256=wO8Ui19Jd4r_LQ9Iirlo0WQamcxu1H6NuVWf87soKwk,18027
|
|
89
97
|
tunacode/tools/update_file.py,sha256=0KTbEe1awS53CZPh1G3F3-TWuemWWBuDVQhcRYwXKOg,7619
|
|
90
98
|
tunacode/tools/write_file.py,sha256=WHEXdUKqUHZZ8Jh1muyupJgjud-x6h99x7qAMaloLao,6021
|
|
99
|
+
tunacode/tools/xml_helper.py,sha256=iDEUeLDNWwdGFyb8T9Vqfo_V7oX7oXm4l3IFPTdJtCM,2996
|
|
91
100
|
tunacode/tools/grep_components/__init__.py,sha256=qy3kwzxOiE6ydlRzpCC39TaIp5BJc5X_bRfXukiu4eM,266
|
|
92
101
|
tunacode/tools/grep_components/file_filter.py,sha256=-XYlmVLOipjuAGdLhHDApLMKZJ1qtlzRUXvOvHc7VYU,3152
|
|
93
102
|
tunacode/tools/grep_components/pattern_matcher.py,sha256=ZvEUqBZ6UWf9wZzb1DIRGSTFQuJCBV0GJG3DVG4r4Ss,5177
|
|
@@ -104,6 +113,10 @@ tunacode/tools/prompts/run_command_prompt.xml,sha256=JVz0CXdXrI6nthI9QaWN-b1OTTl
|
|
|
104
113
|
tunacode/tools/prompts/todo_prompt.xml,sha256=_fuPhhJYWwIx4No1G2yAyEt054aoybWGfUuzVY8OHWc,4602
|
|
105
114
|
tunacode/tools/prompts/update_file_prompt.xml,sha256=TmIc8K6myqgT_eauYMZmHPfhj-y1S3Gcp680e40pfyA,2831
|
|
106
115
|
tunacode/tools/prompts/write_file_prompt.xml,sha256=n7Q2evuCT0NLEDcoiiBkFcjBeQayF66TF5u-bYplk7U,1610
|
|
116
|
+
tunacode/tutorial/__init__.py,sha256=JyTt2S2cy8u1PnoChBmcOPk1Ru7ElhierltCLqZ-2BY,163
|
|
117
|
+
tunacode/tutorial/content.py,sha256=qaQewFwXtKKEmzLH-4oMECGAa4Z4nd1qh2HfRWLpwyk,3278
|
|
118
|
+
tunacode/tutorial/manager.py,sha256=ZgkzSC6ZtYSDq5Ce_TfYk9O9cvgFSL-pXrLZb7_HStM,6309
|
|
119
|
+
tunacode/tutorial/steps.py,sha256=l2bbRVJuYlC186A-U1TIoMPBtLl4j053h4Wlzo1VO8c,4393
|
|
107
120
|
tunacode/ui/__init__.py,sha256=aRNE2pS50nFAX6y--rSGMNYwhz905g14gRd6g4BolYU,13
|
|
108
121
|
tunacode/ui/completers.py,sha256=18f1Im5210-b-qNKyCoOMnSjW99FXNoF0DtgRvEWTm0,4901
|
|
109
122
|
tunacode/ui/console.py,sha256=HfE30vUy8ebXCobP7psFNJc17-dvH6APChg2tbi7aTw,2632
|
|
@@ -113,7 +126,7 @@ tunacode/ui/input.py,sha256=WcbQ93Ct-Eu5CZkzFrmIz4eIN6wDbG4iegr9N6Vjzrk,3306
|
|
|
113
126
|
tunacode/ui/keybindings.py,sha256=8j58NN432XyawffssFNe86leXaPur12qBX3O7hOOGsc,2374
|
|
114
127
|
tunacode/ui/lexers.py,sha256=tmg4ic1enyTRLzanN5QPP7D_0n12YjX_8ZhsffzhXA4,1340
|
|
115
128
|
tunacode/ui/logging_compat.py,sha256=5v6lcjVaG1CxdY1Zm9FAGr9H7Sy-tP6ihGfhP-5YvAY,1406
|
|
116
|
-
tunacode/ui/output.py,sha256=
|
|
129
|
+
tunacode/ui/output.py,sha256=ybVVutiilOQcULtA1zjjs_tTu5okwxHFp2MHtNz3s2E,6767
|
|
117
130
|
tunacode/ui/panels.py,sha256=jsStKE618qrZjZQGYBBVL__pNIamnRgu0UvE0RG0luA,13461
|
|
118
131
|
tunacode/ui/prompt_manager.py,sha256=HUL6443pFPb41uDAnAKD-sZsrWd_VhWYRGwvrFH_9SI,5618
|
|
119
132
|
tunacode/ui/tool_descriptions.py,sha256=vk61JPIXy7gHNfJ--77maXgK6WwNwxqY47QYsw_a2uw,4126
|
|
@@ -133,9 +146,9 @@ tunacode/utils/security.py,sha256=i3eGKg4o-qY2S_ObTlEaHO93q14iBfiPXR5O7srHn58,65
|
|
|
133
146
|
tunacode/utils/system.py,sha256=J8KqJ4ZqQrNSnM5rrJxPeMk9z2xQQp6dWtI1SKBY1-0,11121
|
|
134
147
|
tunacode/utils/text_utils.py,sha256=HAwlT4QMy41hr53cDbbNeNo05MI461TpI9b_xdIv8EY,7288
|
|
135
148
|
tunacode/utils/token_counter.py,sha256=dmFuqVz4ywGFdLfAi5Mg9bAGf8v87Ek-mHU-R3fsYjI,2711
|
|
136
|
-
tunacode/utils/user_configuration.py,sha256=
|
|
137
|
-
tunacode_cli-0.0.
|
|
138
|
-
tunacode_cli-0.0.
|
|
139
|
-
tunacode_cli-0.0.
|
|
140
|
-
tunacode_cli-0.0.
|
|
141
|
-
tunacode_cli-0.0.
|
|
149
|
+
tunacode/utils/user_configuration.py,sha256=OA-L0BgWNbf9sWpc8lyivgLscwJdpdI8TAYbe0wRs1s,4836
|
|
150
|
+
tunacode_cli-0.0.68.dist-info/METADATA,sha256=tZxl4bfd7zzslehBM9erYLFCI393yWYT4fmhQMdlVkE,6773
|
|
151
|
+
tunacode_cli-0.0.68.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
|
|
152
|
+
tunacode_cli-0.0.68.dist-info/entry_points.txt,sha256=hbkytikj4dGu6rizPuAd_DGUPBGF191RTnhr9wdhORY,51
|
|
153
|
+
tunacode_cli-0.0.68.dist-info/licenses/LICENSE,sha256=Btzdu2kIoMbdSp6OyCLupB1aRgpTCJ_szMimgEnpkkE,1056
|
|
154
|
+
tunacode_cli-0.0.68.dist-info/RECORD,,
|
|
@@ -1,327 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: tunacode-cli
|
|
3
|
-
Version: 0.0.67
|
|
4
|
-
Summary: Your agentic CLI developer.
|
|
5
|
-
Project-URL: Homepage, https://tunacode.xyz/
|
|
6
|
-
Project-URL: Repository, https://github.com/alchemiststudiosDOTai/tunacode
|
|
7
|
-
Project-URL: Issues, https://github.com/alchemiststudiosDOTai/tunacode/issues
|
|
8
|
-
Project-URL: Documentation, https://github.com/alchemiststudiosDOTai/tunacode#readme
|
|
9
|
-
Author-email: larock22 <noreply@github.com>
|
|
10
|
-
License: MIT
|
|
11
|
-
License-File: LICENSE
|
|
12
|
-
Keywords: agent,automation,cli,development
|
|
13
|
-
Classifier: Development Status :: 4 - Beta
|
|
14
|
-
Classifier: Intended Audience :: Developers
|
|
15
|
-
Classifier: Programming Language :: Python :: 3
|
|
16
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
-
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
-
Classifier: Topic :: Software Development
|
|
21
|
-
Classifier: Topic :: Utilities
|
|
22
|
-
Requires-Python: <3.14,>=3.10
|
|
23
|
-
Requires-Dist: click<8.2.0,>=8.0.0
|
|
24
|
-
Requires-Dist: defusedxml
|
|
25
|
-
Requires-Dist: prompt-toolkit==3.0.51
|
|
26
|
-
Requires-Dist: pydantic-ai[logfire]==0.2.6
|
|
27
|
-
Requires-Dist: pygments==2.19.1
|
|
28
|
-
Requires-Dist: rich==14.0.0
|
|
29
|
-
Requires-Dist: tiktoken>=0.5.2
|
|
30
|
-
Requires-Dist: typer<0.10.0,>=0.9.0
|
|
31
|
-
Provides-Extra: dev
|
|
32
|
-
Requires-Dist: autoflake>=2.0.0; extra == 'dev'
|
|
33
|
-
Requires-Dist: bandit; extra == 'dev'
|
|
34
|
-
Requires-Dist: build; extra == 'dev'
|
|
35
|
-
Requires-Dist: dead>=1.5.0; extra == 'dev'
|
|
36
|
-
Requires-Dist: hatch>=1.6.0; extra == 'dev'
|
|
37
|
-
Requires-Dist: mypy; extra == 'dev'
|
|
38
|
-
Requires-Dist: pre-commit; extra == 'dev'
|
|
39
|
-
Requires-Dist: pytest; extra == 'dev'
|
|
40
|
-
Requires-Dist: pytest-asyncio; extra == 'dev'
|
|
41
|
-
Requires-Dist: pytest-cov; extra == 'dev'
|
|
42
|
-
Requires-Dist: ruff; extra == 'dev'
|
|
43
|
-
Requires-Dist: textual-dev; extra == 'dev'
|
|
44
|
-
Requires-Dist: twine; extra == 'dev'
|
|
45
|
-
Requires-Dist: unimport>=1.0.0; extra == 'dev'
|
|
46
|
-
Requires-Dist: vulture>=2.7; extra == 'dev'
|
|
47
|
-
Description-Content-Type: text/markdown
|
|
48
|
-
|
|
49
|
-
# TunaCode CLI
|
|
50
|
-
|
|
51
|
-
<div align="center">
|
|
52
|
-
|
|
53
|
-
[](https://badge.fury.io/py/tunacode-cli)
|
|
54
|
-
[](https://pepy.tech/project/tunacode-cli)
|
|
55
|
-
[](https://www.python.org/downloads/)
|
|
56
|
-
[](https://opensource.org/licenses/MIT)
|
|
57
|
-
|
|
58
|
-
**AI-powered CLI coding assistant**
|
|
59
|
-
|
|
60
|
-

|
|
61
|
-
|
|
62
|
-
</div>
|
|
63
|
-
|
|
64
|
-
---
|
|
65
|
-
|
|
66
|
-
## Quick Install
|
|
67
|
-
|
|
68
|
-
```bash
|
|
69
|
-
# Option 1: One-line install (Linux/macOS)
|
|
70
|
-
wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
|
|
71
|
-
|
|
72
|
-
# Option 2: pip install
|
|
73
|
-
pip install tunacode-cli
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
## Development Installation
|
|
77
|
-
|
|
78
|
-
For contributors and developers who want to work on TunaCode:
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
# Clone the repository
|
|
82
|
-
git clone https://github.com/alchemiststudiosDOTai/tunacode.git
|
|
83
|
-
cd tunacode
|
|
84
|
-
|
|
85
|
-
# Quick setup (recommended)
|
|
86
|
-
./scripts/setup_dev_env.sh
|
|
87
|
-
|
|
88
|
-
# Or manual setup
|
|
89
|
-
python3 -m venv venv
|
|
90
|
-
source venv/bin/activate # On Windows: venv\Scripts\activate
|
|
91
|
-
pip install -e ".[dev]"
|
|
92
|
-
|
|
93
|
-
# Verify installation
|
|
94
|
-
python -m tunacode --version
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
See [Development Guide](docs/DEVELOPMENT.md) for detailed instructions.
|
|
98
|
-
|
|
99
|
-
## Configuration
|
|
100
|
-
|
|
101
|
-
Choose your AI provider and set your API key:
|
|
102
|
-
|
|
103
|
-
```bash
|
|
104
|
-
# OpenAI
|
|
105
|
-
tunacode --model "openai:gpt-4o" --key "sk-your-openai-key"
|
|
106
|
-
|
|
107
|
-
# Anthropic Claude
|
|
108
|
-
tunacode --model "anthropic:claude-3.5-sonnet" --key "sk-ant-your-anthropic-key"
|
|
109
|
-
|
|
110
|
-
# OpenRouter (100+ models)
|
|
111
|
-
tunacode --model "openrouter:openai/gpt-4o" --key "sk-or-your-openrouter-key"
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
Your config is saved to `~/.config/tunacode.json`. This file stores your API keys, model preferences, and runtime settings like `max_iterations` (default: 40) and `context_window_size`. You can edit it directly with `nvim ~/.config/tunacode.json` or see [the complete configuration example](documentation/configuration/config-file-example.md) for all available options.
|
|
115
|
-
|
|
116
|
-
### Recommended Models
|
|
117
|
-
|
|
118
|
-
Based on extensive testing, these models provide the best performance:
|
|
119
|
-
|
|
120
|
-
- `google/gemini-2.5-pro` - Excellent for complex reasoning
|
|
121
|
-
- `openai/gpt-4.1` - Strong general-purpose model
|
|
122
|
-
- `deepseek/deepseek-r1-0528` - Great for code generation
|
|
123
|
-
- `openai/gpt-4.1-mini` - Fast and cost-effective
|
|
124
|
-
- `anthropic/claude-4-sonnet-20250522` - Superior context handling
|
|
125
|
-
|
|
126
|
-
_Note: Formal evaluations coming soon. Any model can work, but these have shown the best results in practice._
|
|
127
|
-
|
|
128
|
-
## Start Coding
|
|
129
|
-
|
|
130
|
-
```bash
|
|
131
|
-
tunacode
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
## Basic Commands
|
|
135
|
-
|
|
136
|
-
| Command | Description |
|
|
137
|
-
| ------------------------ | ---------------------- |
|
|
138
|
-
| `/help` | Show all commands |
|
|
139
|
-
| `/model <provider:name>` | Switch model |
|
|
140
|
-
| `/clear` | Clear message history |
|
|
141
|
-
| `/compact` | Summarize conversation |
|
|
142
|
-
| `/branch <name>` | Create Git branch |
|
|
143
|
-
| `/yolo` | Skip confirmations |
|
|
144
|
-
| `!<command>` | Run shell command |
|
|
145
|
-
| `exit` | Exit TunaCode |
|
|
146
|
-
|
|
147
|
-
## Performance
|
|
148
|
-
|
|
149
|
-
TunaCode leverages parallel execution for read-only operations, achieving **3x faster** file operations:
|
|
150
|
-
|
|
151
|
-

|
|
152
|
-
|
|
153
|
-
Multiple file reads, directory listings, and searches execute concurrently using async I/O, making code exploration significantly faster.
|
|
154
|
-
|
|
155
|
-
## Features in Development
|
|
156
|
-
|
|
157
|
-
- **Streaming UI**: Currently working on implementing streaming responses for better user experience
|
|
158
|
-
- **Bug Fixes**: Actively addressing issues - please report any bugs you encounter!
|
|
159
|
-
|
|
160
|
-
_Note: While the tool is fully functional, we're focusing on stability and core features before optimizing for speed._
|
|
161
|
-
|
|
162
|
-
## Safety First
|
|
163
|
-
|
|
164
|
-
⚠️ **Important**: TunaCode can modify your codebase. Always:
|
|
165
|
-
|
|
166
|
-
- Use Git branches before making changes
|
|
167
|
-
- Review file modifications before confirming
|
|
168
|
-
- Keep backups of important work
|
|
169
|
-
|
|
170
|
-
## Documentation
|
|
171
|
-
|
|
172
|
-
- [**Features**](docs/FEATURES.md) - All features, tools, and commands
|
|
173
|
-
- [**Advanced Configuration**](docs/ADVANCED-CONFIG.md) - Provider setup, MCP, customization
|
|
174
|
-
- [**Architecture**](docs/ARCHITECTURE.md) - Source code organization and design
|
|
175
|
-
- [**Development**](docs/DEVELOPMENT.md) - Contributing and development setup
|
|
176
|
-
- [**Troubleshooting**](docs/TROUBLESHOOTING.md) - Common issues and solutions
|
|
177
|
-
|
|
178
|
-
## Links
|
|
179
|
-
|
|
180
|
-
- [PyPI Package](https://pypi.org/project/tunacode-cli/)
|
|
181
|
-
- [GitHub Repository](https://github.com/alchemiststudiosDOTai/tunacode)
|
|
182
|
-
- [Report Issues](https://github.com/alchemiststudiosDOTai/tunacode/issues)
|
|
183
|
-
|
|
184
|
-
---
|
|
185
|
-
|
|
186
|
-
MIT License - see [LICENSE](LICENSE) file
|
|
187
|
-
|
|
188
|
-
hello from tuna world
|
|
189
|
-
|
|
190
|
-
hello world
|
|
191
|
-
|
|
192
|
-
## Getting Started
|
|
193
|
-
|
|
194
|
-
### Prerequisites
|
|
195
|
-
|
|
196
|
-
Before you begin, ensure you have the following installed:
|
|
197
|
-
|
|
198
|
-
- Python 3.10 or higher
|
|
199
|
-
- Git
|
|
200
|
-
|
|
201
|
-
### Installation
|
|
202
|
-
|
|
203
|
-
To install TunaCode, you can use one of the following methods:
|
|
204
|
-
|
|
205
|
-
```bash
|
|
206
|
-
# Option 1: One-line install (Linux/macOS)
|
|
207
|
-
wget -qO- https://raw.githubusercontent.com/alchemiststudiosDOTai/tunacode/master/scripts/install_linux.sh | bash
|
|
208
|
-
|
|
209
|
-
# Option 2: pip install
|
|
210
|
-
pip install tunacode-cli
|
|
211
|
-
```
|
|
212
|
-
|
|
213
|
-
### Development Installation
|
|
214
|
-
|
|
215
|
-
For developers who want to contribute to TunaCode:
|
|
216
|
-
|
|
217
|
-
```bash
|
|
218
|
-
# Clone the repository
|
|
219
|
-
git clone https://github.com/alchemiststudiosDOTai/tunacode.git
|
|
220
|
-
cd tunacode
|
|
221
|
-
|
|
222
|
-
# Quick setup (recommended)
|
|
223
|
-
./scripts/setup_dev_env.sh
|
|
224
|
-
|
|
225
|
-
# Or manual setup
|
|
226
|
-
python3 -m venv venv
|
|
227
|
-
source venv/bin/activate # On Windows: venv\Scripts\activate
|
|
228
|
-
pip install -e ".[dev]"
|
|
229
|
-
|
|
230
|
-
# Verify installation
|
|
231
|
-
python -m tunacode --version
|
|
232
|
-
```
|
|
233
|
-
|
|
234
|
-
See [Development Guide](docs/DEVELOPMENT.md) for detailed instructions.
|
|
235
|
-
|
|
236
|
-
### Configuration
|
|
237
|
-
|
|
238
|
-
Choose your AI provider and set your API key:
|
|
239
|
-
|
|
240
|
-
```bash
|
|
241
|
-
# OpenAI
|
|
242
|
-
tunacode --model "openai:gpt-4o" --key "sk-your-openai-key"
|
|
243
|
-
|
|
244
|
-
# Anthropic Claude
|
|
245
|
-
tunacode --model "anthropic:claude-3.5-sonnet" --key "sk-ant-your-anthropic-key"
|
|
246
|
-
|
|
247
|
-
# OpenRouter (100+ models)
|
|
248
|
-
tunacode --model "openrouter:openai/gpt-4o" --key "sk-or-your-openrouter-key"
|
|
249
|
-
```
|
|
250
|
-
|
|
251
|
-
Your config is saved to `~/.config/tunacode.json`. This file stores your API keys, model preferences, and runtime settings like `max_iterations` (default: 40) and `context_window_size`. You can edit it directly with `nvim ~/.config/tunacode.json` or see [the complete configuration example](documentation/configuration/config-file-example.md) for all available options.
|
|
252
|
-
|
|
253
|
-
### Recommended Models
|
|
254
|
-
|
|
255
|
-
Based on extensive testing, these models provide the best performance:
|
|
256
|
-
|
|
257
|
-
- `google/gemini-2.5-pro` - Excellent for complex reasoning
|
|
258
|
-
- `openai/gpt-4.1` - Strong general-purpose model
|
|
259
|
-
- `deepseek/deepseek-r1-0528` - Great for code generation
|
|
260
|
-
- `openai/gpt-4.1-mini` - Fast and cost-effective
|
|
261
|
-
- `anthropic/claude-4-sonnet-20250522` - Superior context handling
|
|
262
|
-
|
|
263
|
-
_Note: Formal evaluations coming soon. Any model can work, but these have shown the best results in practice._
|
|
264
|
-
|
|
265
|
-
## Usage
|
|
266
|
-
|
|
267
|
-
### Starting TunaCode
|
|
268
|
-
|
|
269
|
-
```bash
|
|
270
|
-
tunacode
|
|
271
|
-
```
|
|
272
|
-
|
|
273
|
-
### Basic Commands
|
|
274
|
-
|
|
275
|
-
| Command | Description |
|
|
276
|
-
| ------------------------ | ---------------------- |
|
|
277
|
-
| `/help` | Show all commands |
|
|
278
|
-
| `/model <provider:name>` | Switch model |
|
|
279
|
-
| `/clear` | Clear message history |
|
|
280
|
-
| `/compact` | Summarize conversation |
|
|
281
|
-
| `/branch <name>` | Create Git branch |
|
|
282
|
-
| `/yolo` | Skip confirmations |
|
|
283
|
-
| `!<command>` | Run shell command |
|
|
284
|
-
| `exit` | Exit TunaCode |
|
|
285
|
-
|
|
286
|
-
## Performance
|
|
287
|
-
|
|
288
|
-
TunaCode leverages parallel execution for read-only operations, achieving **3x faster** file operations:
|
|
289
|
-
|
|
290
|
-

|
|
291
|
-
|
|
292
|
-
Multiple file reads, directory listings, and searches execute concurrently using async I/O, making code exploration significantly faster.
|
|
293
|
-
|
|
294
|
-
## Features in Development
|
|
295
|
-
|
|
296
|
-
- **Streaming UI**: Currently working on implementing streaming responses for better user experience
|
|
297
|
-
- **Bug Fixes**: Actively addressing issues - please report any bugs you encounter!
|
|
298
|
-
|
|
299
|
-
_Note: While the tool is fully functional, we're focusing on stability and core features before optimizing for speed._
|
|
300
|
-
|
|
301
|
-
## Safety First
|
|
302
|
-
|
|
303
|
-
⚠️ **Important**: TunaCode can modify your codebase. Always:
|
|
304
|
-
|
|
305
|
-
- Use Git branches before making changes
|
|
306
|
-
- Review file modifications before confirming
|
|
307
|
-
- Keep backups of important work
|
|
308
|
-
|
|
309
|
-
## Documentation
|
|
310
|
-
|
|
311
|
-
- [**Features**](docs/FEATURES.md) - All features, tools, and commands
|
|
312
|
-
- [**Advanced Configuration**](docs/ADVANCED-CONFIG.md) - Provider setup, MCP, customization
|
|
313
|
-
- [**Architecture**](docs/ARCHITECTURE.md) - Source code organization and design
|
|
314
|
-
- [**Development**](docs/DEVELOPMENT.md) - Contributing and development setup
|
|
315
|
-
- [**Troubleshooting**](docs/TROUBLESHOOTING.md) - Common issues and solutions
|
|
316
|
-
|
|
317
|
-
## Links
|
|
318
|
-
|
|
319
|
-
- [PyPI Package](https://pypi.org/project/tunacode-cli/)
|
|
320
|
-
- [GitHub Repository](https://github.com/alchemiststudiosDOTai/tunacode)
|
|
321
|
-
- [Report Issues](https://github.com/alchemiststudiosDOTai/tunacode/issues)
|
|
322
|
-
|
|
323
|
-
---
|
|
324
|
-
|
|
325
|
-
MIT License - see [LICENSE](LICENSE) file
|
|
326
|
-
# Test
|
|
327
|
-
# Test
|
|
File without changes
|
|
File without changes
|
|
File without changes
|