utim-cli 1.0.0__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.
@@ -0,0 +1,134 @@
1
+ Metadata-Version: 2.4
2
+ Name: utim-cli
3
+ Version: 1.0.0
4
+ Summary: UTIM – Universal Terminal Intelligence Manager. A powerful agentic AI coding assistant for your terminal.
5
+ License: MIT
6
+ Project-URL: Homepage, https://utim.ai
7
+ Project-URL: Documentation, https://utim.ai/docs
8
+ Project-URL: Changelog, https://github.com/emendai/utim/blob/main/CHANGELOG.md
9
+ Project-URL: Issues, https://github.com/emendai/utim/issues
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Programming Language :: Python :: 3.9
12
+ Classifier: Programming Language :: Python :: 3.10
13
+ Classifier: Programming Language :: Python :: 3.11
14
+ Classifier: Programming Language :: Python :: 3.12
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Operating System :: OS Independent
17
+ Classifier: Development Status :: 4 - Beta
18
+ Classifier: Environment :: Console
19
+ Classifier: Intended Audience :: Developers
20
+ Requires-Python: >=3.9
21
+ Description-Content-Type: text/markdown
22
+ License-File: LICENSE
23
+ Requires-Dist: openai>=1.30.0
24
+ Requires-Dist: requests==2.31.0
25
+ Requires-Dist: aiohttp>=3.9.5
26
+ Requires-Dist: python-dotenv==1.0.1
27
+ Requires-Dist: urllib3==1.26.18
28
+ Requires-Dist: charset-normalizer==3.3.2
29
+ Requires-Dist: chardet==4.0.0
30
+ Requires-Dist: typer>=0.9.0
31
+ Requires-Dist: rich>=13.0.0
32
+ Requires-Dist: prompt_toolkit>=3.0.0
33
+ Requires-Dist: tree-sitter>=0.21.0
34
+ Requires-Dist: tree-sitter-python>=0.21.0
35
+ Requires-Dist: tree-sitter-javascript>=0.21.0
36
+ Requires-Dist: tree-sitter-typescript>=0.21.0
37
+ Requires-Dist: mcp>=0.1.0
38
+ Requires-Dist: nest-asyncio>=1.5.0
39
+ Requires-Dist: python-multipart>=0.0.7
40
+ Provides-Extra: search
41
+ Requires-Dist: scrapy>=2.11.0; extra == "search"
42
+ Requires-Dist: scrapy-playwright>=0.0.34; extra == "search"
43
+ Requires-Dist: beautifulsoup4>=4.12.0; extra == "search"
44
+ Provides-Extra: images
45
+ Requires-Dist: pillow>=9.0.0; extra == "images"
46
+ Provides-Extra: full
47
+ Requires-Dist: scrapy>=2.11.0; extra == "full"
48
+ Requires-Dist: scrapy-playwright>=0.0.34; extra == "full"
49
+ Requires-Dist: beautifulsoup4>=4.12.0; extra == "full"
50
+ Requires-Dist: pillow>=9.0.0; extra == "full"
51
+ Dynamic: license-file
52
+
53
+ # UTIM CLI Agent: Enterprise Coder Assistant
54
+
55
+ UTIM is an agentic developer CLI assistant designed to automate coding tasks directly inside your local terminal, featuring robust safety controls, self-healing quality gates, and local-first semantic memory.
56
+
57
+ ---
58
+
59
+ ## 🚀 Quick Start
60
+
61
+ ### 1. Installation
62
+ Install the package from your local source directory:
63
+
64
+ ```bash
65
+ # Basic installation
66
+ pip install .
67
+
68
+ # Recommended: Full installation (includes semantic vector RAG & web search)
69
+ pip install ".[full]"
70
+ ```
71
+
72
+ ### 2. Provider & Model Configuration
73
+ Start the chat session:
74
+ ```bash
75
+ utim
76
+ ```
77
+ On first run, UTIM checks for `.utim/config.json`. If it does not exist, it runs a provider and model configuration wizard. You can configure:
78
+ - **Default Providers**: OpenRouter, OpenAI, custom servers, etc.
79
+ - **Model Picker**: Press `Ctrl+M` in the chat terminal at any time to configure, pick, add, or delete LLMs.
80
+
81
+ ---
82
+
83
+ ## ⚡ Main CLI Commands
84
+
85
+ - **`utim`**: Starts the interactive chat terminal (TUI).
86
+ - **`utim task "<prompt>"`**: Executes a single task autonomously from the command line and exits. In an interactive terminal (`stdin` is a TTY) file writes and commands prompt for confirmation; when piped/scripted they run in auto-accept mode.
87
+ - **`utim --dry-run`**: Starts the session in **Dry-Run Mode** (all code modifications and shell commands are simulated, not written/executed).
88
+ - **`utim --sandbox`**: Runs all mutating shell command proposals in the intelligent local sandbox (untrusted commands will block until approved).
89
+ - **`utim doctor`** / **`utim init`** / **`utim reset`**: Administrative commands for state diagnosis, initialization, and factory resets.
90
+
91
+ ---
92
+
93
+ ## 🛠️ In-Chat Slash Commands
94
+
95
+ Inside the interactive chat terminal, type these slash commands for direct workspace control:
96
+
97
+ - **`/undo`**: Reverts the last assistant action, restoring files to their exact "before" state and rolling back messages.
98
+ - **`/redo`**: Re-applies the last undone turn, re-writing files and restoring conversation logs.
99
+ - **`/rewind <turn_index>`**: Rolls back the entire session to a specific conversation turn.
100
+ - **`/doctor`**: Run diagnostics on environment variables, Python version, dependencies, API model connections, and MCP server status.
101
+ - **`/report`**: Generates a support bundle under `.utim_tmp/report_bundle.zip` (automatically redacts secrets, passwords, or personal names/files).
102
+ - **`/reset`**: Wipes the current chat history without deleting persistent local vector memory.
103
+
104
+ ---
105
+
106
+ ## 🧠 Architecture & How it Works
107
+
108
+ 1. **Local Memory (`.utim/memory.json` & ChromaDB)**:
109
+ - Global user preferences, rules, and facts are synced to a semantic vector database (`.utim_tmp/vector_db`).
110
+ - Relevant memories are dynamically fetched via semantic similarity (RAG) and injected into the system prompt context, preventing prompt bloating.
111
+ 2. **Undo/Redo Stack & Session State**:
112
+ - Every file change (writes, batch string edits, moves, deletions) computes a diff snapshot.
113
+ - The entire stack is serialized dynamically to `.utim/session_state.json`. You can close your shell, shut down your computer, and resume later with intact rollback features.
114
+ 3. **Workspace Boundary & Safety Controls**:
115
+ - Prior to writing files, UTIM performs **Pre-Commit Syntax Checks** (AST compilation for Python, JSON loads, JS/TS checks).
116
+ - If tests are available (`pytest`, `npm test`, etc.), UTIM runs them in a background **Regression testing loop**, prompting the model to self-heal code errors if assertions fail.
117
+ - **Interactive TUI mode** (`utim`): every file mutation shows an interactive diff dialog; the developer accepts, edits, or rejects individual hunks before they are applied.
118
+ - **CLI task mode** (`utim task`): when running in a real terminal, destructive operations (`rm`, package installs, `>` redirects) prompt for `y/n` confirmation. When stdin is piped/non-interactive all edits are auto-accepted.
119
+ - **Sandbox mode** (`utim --sandbox`): classifies every terminal command as safe or risky and blocks risky commands until explicitly approved.
120
+
121
+ ---
122
+
123
+ ## ⚠️ What this Tool Can and Cannot Do
124
+
125
+ ### Can Do:
126
+ - Read, write, and patch codebases safely.
127
+ - Install and coordinate custom MCP (Model Context Protocol) servers.
128
+ - Self-heal syntax and test errors before files are written.
129
+ - Revert any file modification instantly.
130
+
131
+ ### Cannot Do:
132
+ - **No Remote Code Execution**: Runs locally on your machine.
133
+ - **Unverified Sensitive Reads Blocked**: Reading files or memory matching sensitive keys (like passwords, secret codes, or personal data) is blocked unless verified via your configured verification code.
134
+ - **No Auto-Deletions**: Any command that deletes files outside the working directory is blocked automatically.
@@ -0,0 +1,34 @@
1
+ utim_cli/__init__.py,sha256=CgkgZbiB4q24nGgyZdKgueAcomIJRYswGP4yASQT5H8,1535
2
+ utim_cli/agent.py,sha256=RaPT9sa1zkyWpFI8wS0L0_jIXzaM3Q0Yzfw54kUAhqo,14656
3
+ utim_cli/auth.py,sha256=8IbDxpijKvhwOFM0uVsVcNwIc6_crWogjk86Ff1SiOk,7687
4
+ utim_cli/backup.py,sha256=xxUnqAYCOEUU5qUZ7UN8s6jJXHW7Bz6XV1PAOVrhxDA,3300
5
+ utim_cli/billing.py,sha256=rupdaIVJJyiHtczFZHZT8BV-SoCTAi9t7V0SilejNTg,1452
6
+ utim_cli/blender_agent.py,sha256=j-UHqJVwCwE1Pm61SVU_1NVV_WJ9Ei-ZmrKtSLOWOko,42967
7
+ utim_cli/bootstrap.py,sha256=CPzWQdmf512tiuPPyISflAdPtYu8zX5AVRhzEd6D7a0,14185
8
+ utim_cli/client_utils.py,sha256=8C5lPy-uifY7urPhJYKt1zJ0t1xMAkxWx94GrYSON1E,5448
9
+ utim_cli/config.py,sha256=Je2sAfNl72Ti_c7fz6WbtHU-O_fAY1jYggzd2lz_7JU,6876
10
+ utim_cli/context_pruner.py,sha256=U3MpHd3cFz2kyjdlkc4CP39qU8WlUn-ZA0Ur5bhn__E,22317
11
+ utim_cli/doctor.py,sha256=liI9h0JoDGqTH9hjLQsVlpZzLXIeq1VuS233Ah5k0Bo,5094
12
+ utim_cli/knowledge_graph.py,sha256=ocIQXCMH1iu9VL03Jjw2M6r81wvlC10KpYCCCl9FADU,17072
13
+ utim_cli/logger.py,sha256=55M4lZt1VxfhcpPfCQEHoVk-MykCz0jfhWCXGQTiEJE,3854
14
+ utim_cli/mcp_clean_wrapper.py,sha256=Z8oX4wA0DmC_5-DBOHheERHe5rYeI5T9Th9OHxR4HA4,1673
15
+ utim_cli/mcp_client.py,sha256=08i4XmGKXswR_C8DQGqCd2S8mbrM8RDHTt3oxR69Mx4,7830
16
+ utim_cli/mcp_registry.json,sha256=6SyU9uySuWINpM-uCvgEv119OqgBLmtf9onBmyIipY0,34548
17
+ utim_cli/orchestrator.py,sha256=wpKMYVb5cz_3kwCEtG8I8YFUznHptRlu706dHKz_2dc,165311
18
+ utim_cli/reflection.py,sha256=k5hkr0e6iKRnG4OEHfnI5kr8THbptvG8i3HR5cqM8hg,7870
19
+ utim_cli/report.py,sha256=LCOsscg8QAvby5IAObpkxOrVr1vS9_1lqLkb9Rfnzco,3662
20
+ utim_cli/scrapy_search.py,sha256=blPe4uIvUkizTwXdvXVobHrDTZjLjCDsSVaVCk35lw4,8440
21
+ utim_cli/share.py,sha256=Cg4O6o6HKUm4ylJn5RQHVYwxeNj3FPkcF_eO67M2Qjo,12197
22
+ utim_cli/share_tui.py,sha256=gM3YJHvbyo-kAwzNkCJrC1w4HTNA6VWpOdcA9vrOloI,19209
23
+ utim_cli/situational_scoring.py,sha256=hwVOtCqOxPdrdHMhQe8nfU3YbEss3T3e0xhyiB8Zm6o,9760
24
+ utim_cli/state.py,sha256=mGslmo1CHazboy7Et9yZsdT050Td4kd_ohhIvqboBQA,714
25
+ utim_cli/tools.py,sha256=mSGMWktdRiTDTFdtBUPne_ZjLX-YY9W0uNA2C2ic4Cw,155022
26
+ utim_cli/utim.py,sha256=WTwySV2YzOuDWU8OoKlXbu-3Y95aLirxxzG2Uba6zvY,162187
27
+ utim_cli/vector_memory.py,sha256=mdybKxjRY0lqjVKsBfq5sRjN68rRJN69bDy4ii7TrGc,24528
28
+ utim_cli/workspace.py,sha256=F8V5SCtPYdOATJ09-msrRP4lo-hrwUC34sU8ly9dR7w,1134
29
+ utim_cli-1.0.0.dist-info/licenses/LICENSE,sha256=qbkZtGrjpZAH7FnARrxU1SV0XbSt71k-halMBMgzAoM,1070
30
+ utim_cli-1.0.0.dist-info/METADATA,sha256=vdXLwhaPY-ywKld03I6RDzAS4X7jjXyx_mLTddwR_lk,6956
31
+ utim_cli-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
32
+ utim_cli-1.0.0.dist-info/entry_points.txt,sha256=ksvyZIMmDSy6ECS0bgp5u3AySMhfs4gWZ5TbjcH0utM,43
33
+ utim_cli-1.0.0.dist-info/top_level.txt,sha256=lSfhZByX7UOO9TRi3IZihiZJOKQVP4-1BAbLKZeqIXA,9
34
+ utim_cli-1.0.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (82.0.1)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ utim = utim_cli.utim:app
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 UTIM Dev Team
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1 @@
1
+ utim_cli