heywtf 0.1.0__tar.gz

heywtf-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 litlig
+
+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.

heywtf-0.1.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: heywtf
+Version: 0.1.0
+Summary: AI-powered terminal assistant — ask anything or diagnose failures with 'hey wtf'
+License-Expression: MIT
+Keywords: terminal,cli,ai,assistant,ollama,llm,shell
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: google-generativeai>=0.5.0
+Dynamic: license-file
+
+# heywtf
+
+AI-powered terminal assistant for macOS. Ask how to do things in the terminal, or diagnose the last failed command.
+
+> **Platform:** macOS with zsh. Linux works for `hey` queries but `hey wtf` shell integration is zsh-only.
+
+**Backends:**
+- **Ollama** — local, private, no API key (default)
+- **OpenAI** — GPT-4o, GPT-4o-mini (API key required)
+- **Gemini** — Google Gemini (API key required)
+
+## Install
+
+### macOS
+
+```bash
+brew install litlig/tap/heywtf
+```
+
+### Linux / manual
+
+```bash
+git clone https://github.com/litlig/heywtf.git
+cd heywtf
+pip install -e .
+```
+
+## First-time setup
+
+Run the interactive setup wizard:
+
+```bash
+hey config
+```
+
+It will ask you to choose a backend, set an API key if needed, and optionally add shell integration to your `~/.zshrc` so `hey wtf` works.
+
+## Usage
+
+### Ask a question
+
+```bash
+hey how to count words in a file
+hey find all python files modified in the last 24 hours
+hey compress a directory with tar
+```
+
+### Diagnose a failed command
+
+After any failed command, run:
+
+```bash
+hey wtf
+```
+
+Example:
+
+```
+$ chmod 777 /etc/hosts
+chmod: changing permissions of '/etc/hosts': Operation not permitted
+
+$ hey wtf
+
+  heywtf • powered by ollama (qwen2.5-coder:0.5b)
+  ❌ Command failed: chmod 777 /etc/hosts
+  ──────────────────────────────────────────────────
+
+  Permission denied — use sudo for system files:
+  sudo chmod 777 /etc/hosts
+```
+
+Requires shell integration (set up via `hey config`). To temporarily pause capture:
+
+```bash
+buddy-off   # pause (e.g. before an interactive session)
+buddy-on    # resume
+```
+
+### One-off backend override
+
+```bash
+hey o explain async/await in Python    # use OpenAI for this query
+hey g what is the difference between TCP and UDP  # use Gemini for this query
+```
+
+### Configure
+
+```bash
+hey config           # interactive setup wizard
+hey config show      # view current config
+hey config set backend openai          # set default backend
+hey config set openai_api_key sk-...   # set API key
+hey config set ollama_model qwen3-coder:3b
+```
+
+API keys can also be set via environment variables: `OPENAI_API_KEY`, `GOOGLE_API_KEY`.
+
+## Ollama setup
+
+Ollama is the default backend — local, private, no API key needed.
+
+```bash
+brew install ollama
+ollama serve
+ollama pull qwen2.5-coder:0.5b
+```
+
+## How `hey wtf` works
+
+1. A `preexec` zsh hook captures each command and its stderr
+2. A `precmd` hook checks the exit code — if non-zero, saves the command + error
+3. `hey wtf` reads that saved context and asks the AI to diagnose it
+4. Interactive commands (vim, ssh, top, etc.) are skipped to avoid breaking them
+
+## Architecture
+
+- **`heywtf/providers.py`** — abstract `Provider` base class + `Backend` enum
+- **`heywtf/provider_factory.py`** — instantiates providers by backend
+- **`heywtf/ollama_client.py`** — Ollama (local inference)
+- **`heywtf/openai_provider.py`** — OpenAI API
+- **`heywtf/gemini_provider.py`** — Google Gemini API
+- **`heywtf/config.py`** — config read/write (`~/.config/heywtf/config.json`)
+- **`heywtf/cli.py`** — entry points and interactive config wizard
+- **`heywtf/prompts.py`** — system prompts for ask vs. wtf modes
+- **`heywtf/display.py`** — Rich terminal UI
+- **`heywtf/shell/buddy.zsh`** — zsh hooks for error capture
+
+Adding a backend: inherit from `Provider`, implement `chat_stream()`, register in `provider_factory.py` and `config.py`.
+
+## Development
+
+```bash
+git clone https://github.com/litlig/heywtf.git
+cd heywtf
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+Test changes immediately:
+
+```bash
+hey how to list files
+hey wtf
+hey config
+```
+
+To test shell hooks in your current session:
+
+```bash
+source heywtf/shell/buddy.zsh
+```
+
+## License
+
+MIT

heywtf-0.1.0/README.md

@@ -0,0 +1,156 @@
+# heywtf
+
+AI-powered terminal assistant for macOS. Ask how to do things in the terminal, or diagnose the last failed command.
+
+> **Platform:** macOS with zsh. Linux works for `hey` queries but `hey wtf` shell integration is zsh-only.
+
+**Backends:**
+- **Ollama** — local, private, no API key (default)
+- **OpenAI** — GPT-4o, GPT-4o-mini (API key required)
+- **Gemini** — Google Gemini (API key required)
+
+## Install
+
+### macOS
+
+```bash
+brew install litlig/tap/heywtf
+```
+
+### Linux / manual
+
+```bash
+git clone https://github.com/litlig/heywtf.git
+cd heywtf
+pip install -e .
+```
+
+## First-time setup
+
+Run the interactive setup wizard:
+
+```bash
+hey config
+```
+
+It will ask you to choose a backend, set an API key if needed, and optionally add shell integration to your `~/.zshrc` so `hey wtf` works.
+
+## Usage
+
+### Ask a question
+
+```bash
+hey how to count words in a file
+hey find all python files modified in the last 24 hours
+hey compress a directory with tar
+```
+
+### Diagnose a failed command
+
+After any failed command, run:
+
+```bash
+hey wtf
+```
+
+Example:
+
+```
+$ chmod 777 /etc/hosts
+chmod: changing permissions of '/etc/hosts': Operation not permitted
+
+$ hey wtf
+
+  heywtf • powered by ollama (qwen2.5-coder:0.5b)
+  ❌ Command failed: chmod 777 /etc/hosts
+  ──────────────────────────────────────────────────
+
+  Permission denied — use sudo for system files:
+  sudo chmod 777 /etc/hosts
+```
+
+Requires shell integration (set up via `hey config`). To temporarily pause capture:
+
+```bash
+buddy-off   # pause (e.g. before an interactive session)
+buddy-on    # resume
+```
+
+### One-off backend override
+
+```bash
+hey o explain async/await in Python    # use OpenAI for this query
+hey g what is the difference between TCP and UDP  # use Gemini for this query
+```
+
+### Configure
+
+```bash
+hey config           # interactive setup wizard
+hey config show      # view current config
+hey config set backend openai          # set default backend
+hey config set openai_api_key sk-...   # set API key
+hey config set ollama_model qwen3-coder:3b
+```
+
+API keys can also be set via environment variables: `OPENAI_API_KEY`, `GOOGLE_API_KEY`.
+
+## Ollama setup
+
+Ollama is the default backend — local, private, no API key needed.
+
+```bash
+brew install ollama
+ollama serve
+ollama pull qwen2.5-coder:0.5b
+```
+
+## How `hey wtf` works
+
+1. A `preexec` zsh hook captures each command and its stderr
+2. A `precmd` hook checks the exit code — if non-zero, saves the command + error
+3. `hey wtf` reads that saved context and asks the AI to diagnose it
+4. Interactive commands (vim, ssh, top, etc.) are skipped to avoid breaking them
+
+## Architecture
+
+- **`heywtf/providers.py`** — abstract `Provider` base class + `Backend` enum
+- **`heywtf/provider_factory.py`** — instantiates providers by backend
+- **`heywtf/ollama_client.py`** — Ollama (local inference)
+- **`heywtf/openai_provider.py`** — OpenAI API
+- **`heywtf/gemini_provider.py`** — Google Gemini API
+- **`heywtf/config.py`** — config read/write (`~/.config/heywtf/config.json`)
+- **`heywtf/cli.py`** — entry points and interactive config wizard
+- **`heywtf/prompts.py`** — system prompts for ask vs. wtf modes
+- **`heywtf/display.py`** — Rich terminal UI
+- **`heywtf/shell/buddy.zsh`** — zsh hooks for error capture
+
+Adding a backend: inherit from `Provider`, implement `chat_stream()`, register in `provider_factory.py` and `config.py`.
+
+## Development
+
+```bash
+git clone https://github.com/litlig/heywtf.git
+cd heywtf
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+Test changes immediately:
+
+```bash
+hey how to list files
+hey wtf
+hey config
+```
+
+To test shell hooks in your current session:
+
+```bash
+source heywtf/shell/buddy.zsh
+```
+
+## License
+
+MIT

heywtf-0.1.0/heywtf/__init__.py

@@ -0,0 +1,3 @@
+"""heywtf — AI-powered shell assistant with multiple backends (Ollama, OpenAI, Gemini)."""
+
+__version__ = "0.1.0"