hey-cli-python 1.0.17__py3-none-any.whl → 1.1.1__py3-none-any.whl

hey_cli/cli.py

@@ -68,6 +68,9 @@ def main():
     parser.add_argument(
         "--check-cache", type=str, help="Check local cache for instant fix"
     )
+    parser.add_argument(
+        "--shell-init", action="store_true", help="Output shell function for directory persistence"
+    )
 
     args = parser.parse_args()
 
@@ -95,6 +98,36 @@ def main():
     if args.check_cache:
         sys.exit(0)
 
+    if args.shell_init:
+        is_windows = os.name == "nt"
+        if is_windows:
+            shell_func = r"""
+function hey {
+    & hey.exe @args
+    $handoff = Join-Path $HOME ".hey_cwd_handoff"
+    if (Test-Path $handoff) {
+        $target = Get-Content $handoff -Raw
+        Remove-Item $handoff
+        if (Test-Path $target.Trim()) {
+            Set-Location $target.Trim()
+        }
+    }
+}
+"""
+        else:
+            shell_func = r"""
+hey() {
+    command hey "$@"
+    if [ -f "$HOME/.hey_cwd_handoff" ]; then
+        local target=$(cat "$HOME/.hey_cwd_handoff")
+        rm -f "$HOME/.hey_cwd_handoff"
+        [ -d "$target" ] && cd "$target"
+    fi
+}
+"""
+        print(shell_func.strip())
+        sys.exit(0)
+
     # Only check Ollama when we're about to call the LLM
     check_ollama()
 

hey_cli/governance.py

@@ -21,7 +21,7 @@ DEFAULT_RULES = {
         "kubectl delete"
     ],
     "allowed": [
-        "ls", "cat", "pwd", "grep", "find", "echo", "tail"
+        "ls", "cat", "pwd", "grep", "find", "echo", "tail", "cd"
     ],
     "high_risk_keywords": [
         "reset", "delete", "drop", "truncate", "prune", "rm", "-exec", ">"

hey_cli/runner.py

@@ -2,6 +2,9 @@ import subprocess
 import sys
 import json
 import dataclasses
+import os
+import platform
+import re
 from typing import Optional
 
 from .governance import GovernanceEngine, Action
@@ -17,17 +20,44 @@ class CommandRunner:
         self.history_mgr = history_mgr
         self.console = Console()
 
-    def run_command(self, cmd: str) -> tuple[int, str]:
+    def run_command(self, cmd: str, capture_pwd: bool = False) -> tuple[int, str]:
         """Executes a command and returns exit code and combined output."""
+        is_windows = platform.system() == "Windows"
         try:
+            full_cmd = cmd
+            if capture_pwd:
+                if is_windows:
+                    # Windows CMD syntax for capturing PWD
+                    full_cmd = f'("{cmd}") & echo. & echo HEY_CWD_HANDOFF:%CD%'
+                else:
+                    # Unix shell syntax
+                    full_cmd = f'{{ {cmd} ; }} ; printf "\\nHEY_CWD_HANDOFF:%s\\n" "$(pwd)"'
+            
             result = subprocess.run(
-                cmd, 
+                full_cmd, 
                 shell=True, 
                 stdout=subprocess.PIPE, 
                 stderr=subprocess.STDOUT, 
                 text=True
             )
-            return result.returncode, result.stdout
+            
+            out = result.stdout
+            if capture_pwd and "HEY_CWD_HANDOFF:" in out:
+                match = re.search(r"HEY_CWD_HANDOFF:(.*)", out)
+                if match:
+                    cwd = match.group(1).strip()
+                    # Clean up output to hide the marker and the extra newline
+                    out = re.sub(r"\n?HEY_CWD_HANDOFF:.*", "", out, flags=re.DOTALL).strip()
+                    
+                    # Normalize paths for comparison (especially on Windows)
+                    norm_cwd = os.path.normpath(cwd).lower() if is_windows else os.path.normpath(cwd)
+                    norm_actual = os.path.normpath(os.getcwd()).lower() if is_windows else os.path.normpath(os.getcwd())
+                    
+                    if norm_cwd != norm_actual:
+                        with open(os.path.expanduser("~/.hey_cwd_handoff"), "w") as f:
+                            f.write(cwd)
+            
+            return result.returncode, out
         except Exception as e:
             return -1, str(e)
 
@@ -146,7 +176,7 @@ class CommandRunner:
         if self.level in (1, 2):
             if self._check_governance(cmd):
                 self.console.print(f"[bold green]● Running:[/bold green] {cmd}")
-                code, out = self.run_command(cmd)
+                code, out = self.run_command(cmd, capture_pwd=True)
                 if out.strip():
                     print(out.strip())
                 sys.exit(code)

{hey_cli_python-1.0.17.dist-info → hey_cli_python-1.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hey-cli-python
-Version: 1.0.17
+Version: 1.1.1
 Summary: A secure, zero-bloat CLI companion that turns natural language and error logs into executable commands.
 Author: Mohit Singh Sinsniwal
 Project-URL: Homepage, https://github.com/sinsniwal/hey-cli
@@ -30,26 +30,22 @@ Dynamic: license-file
   <h1>hey-cli</h1>
   <p><strong>Your terminal buddy that turns plain English into shell scripts — and runs them for you.</strong></p>
 
-  <a href="https://pypi.org/project/hey-cli-python/"><img src="https://img.shields.io/pypi/v/hey-cli-python?label=PyPI&color=blue" alt="PyPI" /></a>
-  <img src="https://img.shields.io/pypi/pyversions/hey-cli-python?color=blue" alt="Python" />
-  <a href="https://github.com/sinsniwal/hey-cli/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License" /></a>
-  <a href="https://github.com/sinsniwal/hey-cli/releases/latest"><img src="https://img.shields.io/github/v/release/sinsniwal/hey-cli?label=Release&color=orange" alt="Release" /></a>
+<a href="https://pypi.org/project/hey-cli-python/"><img src="https://img.shields.io/pypi/v/hey-cli-python?label=PyPI&color=blue" alt="PyPI" /></a>
+<img src="https://img.shields.io/pypi/pyversions/hey-cli-python?color=blue" alt="Python" />
+<a href="https://github.com/sinsniwal/hey-cli/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License" /></a>
+<a href="https://github.com/sinsniwal/hey-cli/releases/latest"><img src="https://img.shields.io/github/v/release/sinsniwal/hey-cli?label=Release&color=orange" alt="Release" /></a>
+
 </div>
 
 <br>
 
 `hey` is a terminal-native AI assistant that translates plain English into executable shell commands using a locally-hosted LLM via [Ollama](https://ollama.com). Your data never leaves your machine.
 
-```
-$ hey find all python files modified in the last 24 hours
-● Thinking...
-
-▶ find . -name "*.py" -mtime -1 -type f
-
-Run this command? [Y/n]:
-```
+<div align="center">
+  <img src="https://github.com/sinsniwal/hey-cli/raw/main/assets/demo.gif" width="800" alt="Hey CLI Demo">
+</div>
 
----
+<br>
 
 ## Features
 
@@ -110,11 +106,13 @@ uv tool install hey-cli-python
 ### Uninstallation
 
 **macOS & Linux:**
+
 ```bash
 curl -sL https://raw.githubusercontent.com/sinsniwal/hey-cli/main/uninstall.sh | bash
 ```
 
 **Windows (PowerShell):**
+
 ```powershell
 Invoke-WebRequest -Uri "https://raw.githubusercontent.com/sinsniwal/hey-cli/main/uninstall.ps1" -OutFile "$env:TEMP\hey_uninstall.ps1"; & "$env:TEMP\hey_uninstall.ps1"
 ```
@@ -129,26 +127,43 @@ hey <your objective in plain English>
 
 ### Examples
 
-| Command | What happens |
-|---------|-------------|
-| `hey list all running docker containers` | Generates and runs `docker ps` |
-| `hey is port 8080 in use?` | Silently runs `lsof -i :8080`, reads output, answers in English |
-| `hey forcefully delete all .pyc files` | Generates `find . -name "*.pyc" -delete`, pauses for confirmation |
-| `hey compress this folder into a tar.gz` | Generates the correct `tar` command for your OS |
-| `npm run build 2>&1 \| hey what broke?` | Reads piped stderr and explains the error |
-| `hey --clear` | Wipes conversational memory |
+| Command                                  | What happens                                                      |
+| ---------------------------------------- | ----------------------------------------------------------------- |
+| `hey list all running docker containers` | Generates and runs `docker ps`                                    |
+| `hey is port 8080 in use?`               | Silently runs `lsof -i :8080`, reads output, answers in English   |
+| `hey forcefully delete all .pyc files`   | Generates `find . -name "*.pyc" -delete`, pauses for confirmation |
+| `hey compress this folder into a tar.gz` | Generates the correct `tar` command for your OS                   |
+| `npm run build 2>&1 \| hey what broke?`  | Reads piped stderr and explains the error                         |
+| `hey --clear`                            | Wipes conversational memory                                       |
 
-### Execution Levels
+---
 
-| Level | Flag | Behavior |
-|-------|------|----------|
-| 0 | `--level 0` | Dry-run — shows the command but never executes |
-| 1 | *(default)* | Supervised — safe commands auto-run, risky ones ask for confirmation |
-| 2 | `--level 2` | Unrestricted — executes everything without confirmation |
-| 3 | `--level 3` | Troubleshooter — iteratively debugs until the objective is resolved |
+## Shell Integration (Recommended)
+
+By default, CLI tools cannot change your terminal's directory because they run in a subshell. To enable `hey` to change your directory (e.g., `hey go to desktop`), add the following to your shell configuration (`~/.zshrc` or `~/.bashrc`):
+
+```bash
+eval "$(hey --shell-init)"
+```
+
+**For Windows (PowerShell):**
+
+```powershell
+hey --shell-init | Out-String | iex
+```
 
 ---
 
+## Execution Levels
+
+| Level | Flag        | Behavior                                                             |
+| ----- | ----------- | -------------------------------------------------------------------- |
+| 0     | `--level 0` | Dry-run — shows the command but never executes                       |
+| 1     | _(default)_ | Supervised — safe commands auto-run, risky ones ask for confirmation |
+| 2     | `--level 2` | Unrestricted — executes everything without confirmation              |
+| 3     | `--level 3` | Troubleshooter — iteratively debugs until the objective is resolved  |
+
+---
 
 ---
 

hey_cli_python-1.1.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+hey_cli/__init__.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,22
+hey_cli/cli.py,sha256=vD8qvCbY3txQBZd4c0qiYRDj28xIV1Ji_wJk76l7DQ0,6090
+hey_cli/governance.py,sha256=vQF_4e-eXVLnuRPeBJm-wKpJho5Hs145epocwrkY3hY,2647
+hey_cli/history.py,sha256=a7xnUMthQQlzeTwfsORpsTBFPMBgo0wcubU603HBrRE,928
+hey_cli/llm.py,sha256=dFy7iYvYE9_ikOblapp0Ehvj-Nk4iqQ47avi9lzg5d4,8757
+hey_cli/models.py,sha256=Jye_btuL39R7BA5bG59JbJFtpDUS0ZrSw0veUUTf0kM,302
+hey_cli/runner.py,sha256=j8eJytN5a6OFvXhjNVI0NpaQoZhaXaaY8nzPtdEHan4,9897
+hey_cli/skills.py,sha256=RX6rSnkQ6FG_hogKUhASI5dazvNAphi2n2c1Rw_NAxw,3569
+hey_cli_python-1.1.1.dist-info/licenses/LICENSE,sha256=15ubdFS3laW1SETf6f8fd8-sbqZeGz_FFdJgJATDAVI,1065
+hey_cli_python-1.1.1.dist-info/METADATA,sha256=sorZ02K8qPY9KENp42oVOwLs9Em_GQkjz5K_VBVG7D8,10011
+hey_cli_python-1.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+hey_cli_python-1.1.1.dist-info/entry_points.txt,sha256=N4bcRze9-LYaO624Gpg5Th_4CSQCDN04EXUHFve7uGw,41
+hey_cli_python-1.1.1.dist-info/top_level.txt,sha256=UNOjINF-x81p5IeEawLMkXdUnlybKKYKx8UGTzP6IuU,8
+hey_cli_python-1.1.1.dist-info/RECORD,,

hey_cli_python-1.0.17.dist-info/RECORD

@@ -1,14 +0,0 @@
-hey_cli/__init__.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,22
-hey_cli/cli.py,sha256=FpBeh9A4_V5-HIZ1SiKLXNlTl4HaL3_hodz4PZ14lrQ,5236
-hey_cli/governance.py,sha256=jRgI9kUtldJFUTTNbRAj6kACKnVZMe_ak-7lmCgz5EA,2641
-hey_cli/history.py,sha256=a7xnUMthQQlzeTwfsORpsTBFPMBgo0wcubU603HBrRE,928
-hey_cli/llm.py,sha256=dFy7iYvYE9_ikOblapp0Ehvj-Nk4iqQ47avi9lzg5d4,8757
-hey_cli/models.py,sha256=Jye_btuL39R7BA5bG59JbJFtpDUS0ZrSw0veUUTf0kM,302
-hey_cli/runner.py,sha256=cEF9vePK-g9VOW-8XrsafR7lyRSHQGMOl45hC2nA7sg,8431
-hey_cli/skills.py,sha256=RX6rSnkQ6FG_hogKUhASI5dazvNAphi2n2c1Rw_NAxw,3569
-hey_cli_python-1.0.17.dist-info/licenses/LICENSE,sha256=15ubdFS3laW1SETf6f8fd8-sbqZeGz_FFdJgJATDAVI,1065
-hey_cli_python-1.0.17.dist-info/METADATA,sha256=IINj7CBVpMT28Sf2AKHOzb7Wv00PmGFAWlBOWg9ZmIQ,9102
-hey_cli_python-1.0.17.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-hey_cli_python-1.0.17.dist-info/entry_points.txt,sha256=N4bcRze9-LYaO624Gpg5Th_4CSQCDN04EXUHFve7uGw,41
-hey_cli_python-1.0.17.dist-info/top_level.txt,sha256=UNOjINF-x81p5IeEawLMkXdUnlybKKYKx8UGTzP6IuU,8
-hey_cli_python-1.0.17.dist-info/RECORD,,