utim-cli 1.0.0__tar.gz

utim_cli-1.0.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to the UTIM CLI Agent will be documented in this file.
+
+## [1.0.0] - 2026-06-23
+
+### Added
+- **Pre-Commit Syntax Checks**: Code files undergo compilation checks (Python AST, JSON, JavaScript check, TypeScript type checks, YAML parsing) in a temporary buffer before being committed.
+- **Interactive Diff Approvals**: Unified git-style diffs are displayed in the terminal UI for user review and approval before modifications are written.
+- **Dry-Run Mode**: Introduced `--dry-run` CLI flag to run UTIM in read-only mode, showing projected changes and simulated commands without mutations.
+- **Automated Regression Testing Loop**: UTIM automatically detects `pytest`, `npm test`, `cargo test`, `go test`, and `tox` suites, executing them after changes and self-healing test failures.
+- **Robust Session Serialization**: Saves full message history, undo/redo stacks, checklist status, and dynamic config states to `.utim/session_state.json`, allowing pause-and-resume.
+- **ChromaDB Semantic Memory**: Syncs local memories to vector databases and uses embedding search instead of checking huge flat files, preventing latency and reasoning loops.
+- **Uninstall Command**: Developers can now uninstall unused/broken MCP servers from the terminal.
+- **`/doctor` Diagnostics Command**: Added system and MCP connection debugging command.
+
+### Changed
+- Refactored test runners to skip heavy external execution during pytest discovery, avoiding execution hangs.
+- Curated out broken presets from the default MCP registry to prevent package installation 404s.
+
+### Fixed
+- Bypassed pre-computation loops and heavy RAG injection for casual queries (e.g. "hello"), bringing response latency down to normal levels.

utim_cli-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UTIM Dev Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

utim_cli-1.0.0/MANIFEST.in

@@ -0,0 +1,46 @@
+# MANIFEST.in — controls what's included in the Python source distribution (sdist)
+# The goal: ship only the utim_cli core package, not server code, tests, or landing site.
+
+# ── Include essentials ─────────────────────────────────────────────────────────
+include README.md
+include LICENSE
+include CHANGELOG.md
+include pyproject.toml
+
+# ── Include the JSON data file bundled with the package ───────────────────────
+include utim_cli/mcp_registry.json
+
+# ── Exclude server sub-package (runs on Railway, not on user machines) ─────────
+prune utim_cli/server
+
+# ── Exclude tests, landing site, build artifacts ──────────────────────────────
+prune tests
+prune landing
+prune build
+prune scripts
+prune .git
+prune .agents
+prune .utim
+prune .utim_backup
+prune .utim_tmp
+prune .antigravitycli
+prune __pycache__
+prune utim_cli/__pycache__
+
+# ── Exclude environment / CI files ────────────────────────────────────────────
+exclude *.db
+exclude *.log
+exclude *.png
+exclude *.jpg
+exclude *.jpeg
+exclude Dockerfile
+exclude Procfile
+exclude railway.toml
+exclude railway.json
+exclude scrapy.cfg
+exclude todo.py
+exclude todo_gui.py
+exclude test_or.py
+exclude test_prompt.py
+exclude bin/utim.cmd
+exclude bin/utim1.cmd

utim_cli-1.0.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: utim-cli
+Version: 1.0.0
+Summary: UTIM – Universal Terminal Intelligence Manager. A powerful agentic AI coding assistant for your terminal.
+License: MIT
+Project-URL: Homepage, https://utim.ai
+Project-URL: Documentation, https://utim.ai/docs
+Project-URL: Changelog, https://github.com/emendai/utim/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/emendai/utim/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai>=1.30.0
+Requires-Dist: requests==2.31.0
+Requires-Dist: aiohttp>=3.9.5
+Requires-Dist: python-dotenv==1.0.1
+Requires-Dist: urllib3==1.26.18
+Requires-Dist: charset-normalizer==3.3.2
+Requires-Dist: chardet==4.0.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: tree-sitter-python>=0.21.0
+Requires-Dist: tree-sitter-javascript>=0.21.0
+Requires-Dist: tree-sitter-typescript>=0.21.0
+Requires-Dist: mcp>=0.1.0
+Requires-Dist: nest-asyncio>=1.5.0
+Requires-Dist: python-multipart>=0.0.7
+Provides-Extra: search
+Requires-Dist: scrapy>=2.11.0; extra == "search"
+Requires-Dist: scrapy-playwright>=0.0.34; extra == "search"
+Requires-Dist: beautifulsoup4>=4.12.0; extra == "search"
+Provides-Extra: images
+Requires-Dist: pillow>=9.0.0; extra == "images"
+Provides-Extra: full
+Requires-Dist: scrapy>=2.11.0; extra == "full"
+Requires-Dist: scrapy-playwright>=0.0.34; extra == "full"
+Requires-Dist: beautifulsoup4>=4.12.0; extra == "full"
+Requires-Dist: pillow>=9.0.0; extra == "full"
+Dynamic: license-file
+
+# UTIM CLI Agent: Enterprise Coder Assistant
+
+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.
+
+---
+
+## 🚀 Quick Start
+
+### 1. Installation
+Install the package from your local source directory:
+
+```bash
+# Basic installation
+pip install .
+
+# Recommended: Full installation (includes semantic vector RAG & web search)
+pip install ".[full]"
+```
+
+### 2. Provider & Model Configuration
+Start the chat session:
+```bash
+utim
+```
+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:
+- **Default Providers**: OpenRouter, OpenAI, custom servers, etc.
+- **Model Picker**: Press `Ctrl+M` in the chat terminal at any time to configure, pick, add, or delete LLMs.
+
+---
+
+## ⚡ Main CLI Commands
+
+- **`utim`**: Starts the interactive chat terminal (TUI).
+- **`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.
+- **`utim --dry-run`**: Starts the session in **Dry-Run Mode** (all code modifications and shell commands are simulated, not written/executed).
+- **`utim --sandbox`**: Runs all mutating shell command proposals in the intelligent local sandbox (untrusted commands will block until approved).
+- **`utim doctor`** / **`utim init`** / **`utim reset`**: Administrative commands for state diagnosis, initialization, and factory resets.
+
+---
+
+## 🛠️ In-Chat Slash Commands
+
+Inside the interactive chat terminal, type these slash commands for direct workspace control:
+
+- **`/undo`**: Reverts the last assistant action, restoring files to their exact "before" state and rolling back messages.
+- **`/redo`**: Re-applies the last undone turn, re-writing files and restoring conversation logs.
+- **`/rewind <turn_index>`**: Rolls back the entire session to a specific conversation turn.
+- **`/doctor`**: Run diagnostics on environment variables, Python version, dependencies, API model connections, and MCP server status.
+- **`/report`**: Generates a support bundle under `.utim_tmp/report_bundle.zip` (automatically redacts secrets, passwords, or personal names/files).
+- **`/reset`**: Wipes the current chat history without deleting persistent local vector memory.
+
+---
+
+## 🧠 Architecture & How it Works
+
+1. **Local Memory (`.utim/memory.json` & ChromaDB)**: 
+   - Global user preferences, rules, and facts are synced to a semantic vector database (`.utim_tmp/vector_db`).
+   - Relevant memories are dynamically fetched via semantic similarity (RAG) and injected into the system prompt context, preventing prompt bloating.
+2. **Undo/Redo Stack & Session State**:
+   - Every file change (writes, batch string edits, moves, deletions) computes a diff snapshot.
+   - 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.
+3. **Workspace Boundary & Safety Controls**:
+   - Prior to writing files, UTIM performs **Pre-Commit Syntax Checks** (AST compilation for Python, JSON loads, JS/TS checks).
+   - 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.
+   - **Interactive TUI mode** (`utim`): every file mutation shows an interactive diff dialog; the developer accepts, edits, or rejects individual hunks before they are applied.
+   - **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.
+   - **Sandbox mode** (`utim --sandbox`): classifies every terminal command as safe or risky and blocks risky commands until explicitly approved.
+
+---
+
+## ⚠️ What this Tool Can and Cannot Do
+
+### Can Do:
+- Read, write, and patch codebases safely.
+- Install and coordinate custom MCP (Model Context Protocol) servers.
+- Self-heal syntax and test errors before files are written.
+- Revert any file modification instantly.
+
+### Cannot Do:
+- **No Remote Code Execution**: Runs locally on your machine.
+- **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.
+- **No Auto-Deletions**: Any command that deletes files outside the working directory is blocked automatically.

utim_cli-1.0.0/README.md

@@ -0,0 +1,82 @@
+# UTIM CLI Agent: Enterprise Coder Assistant
+
+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.
+
+---
+
+## 🚀 Quick Start
+
+### 1. Installation
+Install the package from your local source directory:
+
+```bash
+# Basic installation
+pip install .
+
+# Recommended: Full installation (includes semantic vector RAG & web search)
+pip install ".[full]"
+```
+
+### 2. Provider & Model Configuration
+Start the chat session:
+```bash
+utim
+```
+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:
+- **Default Providers**: OpenRouter, OpenAI, custom servers, etc.
+- **Model Picker**: Press `Ctrl+M` in the chat terminal at any time to configure, pick, add, or delete LLMs.
+
+---
+
+## ⚡ Main CLI Commands
+
+- **`utim`**: Starts the interactive chat terminal (TUI).
+- **`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.
+- **`utim --dry-run`**: Starts the session in **Dry-Run Mode** (all code modifications and shell commands are simulated, not written/executed).
+- **`utim --sandbox`**: Runs all mutating shell command proposals in the intelligent local sandbox (untrusted commands will block until approved).
+- **`utim doctor`** / **`utim init`** / **`utim reset`**: Administrative commands for state diagnosis, initialization, and factory resets.
+
+---
+
+## 🛠️ In-Chat Slash Commands
+
+Inside the interactive chat terminal, type these slash commands for direct workspace control:
+
+- **`/undo`**: Reverts the last assistant action, restoring files to their exact "before" state and rolling back messages.
+- **`/redo`**: Re-applies the last undone turn, re-writing files and restoring conversation logs.
+- **`/rewind <turn_index>`**: Rolls back the entire session to a specific conversation turn.
+- **`/doctor`**: Run diagnostics on environment variables, Python version, dependencies, API model connections, and MCP server status.
+- **`/report`**: Generates a support bundle under `.utim_tmp/report_bundle.zip` (automatically redacts secrets, passwords, or personal names/files).
+- **`/reset`**: Wipes the current chat history without deleting persistent local vector memory.
+
+---
+
+## 🧠 Architecture & How it Works
+
+1. **Local Memory (`.utim/memory.json` & ChromaDB)**: 
+   - Global user preferences, rules, and facts are synced to a semantic vector database (`.utim_tmp/vector_db`).
+   - Relevant memories are dynamically fetched via semantic similarity (RAG) and injected into the system prompt context, preventing prompt bloating.
+2. **Undo/Redo Stack & Session State**:
+   - Every file change (writes, batch string edits, moves, deletions) computes a diff snapshot.
+   - 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.
+3. **Workspace Boundary & Safety Controls**:
+   - Prior to writing files, UTIM performs **Pre-Commit Syntax Checks** (AST compilation for Python, JSON loads, JS/TS checks).
+   - 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.
+   - **Interactive TUI mode** (`utim`): every file mutation shows an interactive diff dialog; the developer accepts, edits, or rejects individual hunks before they are applied.
+   - **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.
+   - **Sandbox mode** (`utim --sandbox`): classifies every terminal command as safe or risky and blocks risky commands until explicitly approved.
+
+---
+
+## ⚠️ What this Tool Can and Cannot Do
+
+### Can Do:
+- Read, write, and patch codebases safely.
+- Install and coordinate custom MCP (Model Context Protocol) servers.
+- Self-heal syntax and test errors before files are written.
+- Revert any file modification instantly.
+
+### Cannot Do:
+- **No Remote Code Execution**: Runs locally on your machine.
+- **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.
+- **No Auto-Deletions**: Any command that deletes files outside the working directory is blocked automatically.

utim_cli-1.0.0/pyproject.toml

@@ -0,0 +1,75 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "utim-cli"
+version = "1.0.0"
+description = "UTIM – Universal Terminal Intelligence Manager. A powerful agentic AI coding assistant for your terminal."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+]
+dependencies = [
+    "openai>=1.30.0",
+    "requests==2.31.0",
+    "aiohttp>=3.9.5",
+    "python-dotenv==1.0.1",
+    "urllib3==1.26.18",
+    "charset-normalizer==3.3.2",
+    "chardet==4.0.0",
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "prompt_toolkit>=3.0.0",
+    "tree-sitter>=0.21.0",
+    "tree-sitter-python>=0.21.0",
+    "tree-sitter-javascript>=0.21.0",
+    "tree-sitter-typescript>=0.21.0",
+    "mcp>=0.1.0",
+    "nest-asyncio>=1.5.0",
+    "python-multipart>=0.0.7",
+]
+
+[project.urls]
+Homepage = "https://utim.ai"
+Documentation = "https://utim.ai/docs"
+Changelog = "https://github.com/emendai/utim/blob/main/CHANGELOG.md"
+Issues = "https://github.com/emendai/utim/issues"
+
+[project.optional-dependencies]
+# Optional features
+search = [
+    "scrapy>=2.11.0",
+    "scrapy-playwright>=0.0.34",
+    "beautifulsoup4>=4.12.0",
+]
+images = [
+    "pillow>=9.0.0",
+]
+full = [
+    "scrapy>=2.11.0",
+    "scrapy-playwright>=0.0.34",
+    "beautifulsoup4>=4.12.0",
+    "pillow>=9.0.0",
+]
+
+[project.scripts]
+utim = "utim_cli.utim:app"
+
+[tool.setuptools.packages.find]
+include = ["utim_cli*"]
+exclude = ["utim_cli.server*", "tests*", "landing*", "scripts*"]
+
+[tool.setuptools.package-data]
+utim_cli = ["mcp_registry.json"]

utim_cli-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

utim_cli-1.0.0/setup.py

@@ -0,0 +1,4 @@
+from setuptools import setup
+
+if __name__ == "__main__":
+    setup()

utim_cli-1.0.0/utim_cli/__init__.py

@@ -0,0 +1,40 @@
+# UTIM CLI Package
+import builtins, os, pathlib, urllib.parse, re
+
+def _make_file_uri(path: str) -> str:
+    p = pathlib.Path(path).resolve()
+    encoded = urllib.parse.quote(str(p).replace('\\', '/'))
+    return f"file:///{encoded}"
+
+def _maybe_path_to_uri(text: str) -> str:
+    # Detect absolute Windows paths (C:\... or /c/... )
+    if re.match(r"^[a-zA-Z]:[\\/].*", text) and os.path.exists(text):
+        return f"{text} ({_make_file_uri(text)})"
+    # Detect relative paths that exist in cwd
+    rel = os.path.abspath(text)
+    if os.path.exists(rel):
+        return f"{text} ({_make_file_uri(rel)})"
+    return text
+
+_orig_print = builtins.print
+
+def _utim_print(*args, **kwargs):
+    formatted = [_maybe_path_to_uri(str(a)) for a in args]
+    try:
+        _orig_print(*formatted, **kwargs)
+    except UnicodeEncodeError:
+        import sys
+        encoding = sys.stdout.encoding or 'cp1252'
+        safe_formatted = []
+        for item in formatted:
+            safe_item = item.encode(encoding, errors='backslashreplace').decode(encoding)
+            safe_formatted.append(safe_item)
+        try:
+            _orig_print(*safe_formatted, **kwargs)
+        except Exception:
+            # Absolute fallback to standard ASCII if everything else fails
+            ascii_formatted = [item.encode('ascii', errors='replace').decode('ascii') for item in formatted]
+            _orig_print(*ascii_formatted, **kwargs)
+
+# Override the global print for this package
+builtins.print = _utim_print