Metadata-Version: 2.4
Name: claudeeye
Version: 1.2.0
Summary: AI assistant that sees your screen — global hotkey, Claude integration
Home-page: https://github.com/mrslothai/claudeeye
Author: Rajesh Chityal
Author-email: rajesh@rajeshchityal.com
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Utilities
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
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: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: anthropic>=0.40.0
Requires-Dist: PyQt6>=6.6.0
Requires-Dist: Pillow>=10.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pynput>=1.7.6
Requires-Dist: requests>=2.28.0
Requires-Dist: mss>=9.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ClaudeEye 👁

## Install
```bash
pip install claudeeye
claudeeye
```

## No API Key Needed! 🎉
ClaudeEye uses your existing **Claude CLI** installation. If you have Claude Code or Claude Max, you're already good to go.

**Prerequisite:** Claude CLI installed and logged in
```bash
npm install -g @anthropic-ai/claude-code
claude /login
```

> AI assistant that sees your screen. No more screenshots.

Give Claude eyes — every message auto-captures your screen so Claude understands your context without you explaining anything.

## Platform Support

| Platform | Status | Screenshot Method |
|----------|--------|-------------------|
| 🐧 Linux | ✅ Fully supported | scrot / GNOME Shell D-Bus |
| 🍎 Mac | ✅ Fully supported | screencapture (silent) |
| 🪟 Windows | ✅ Supported | PIL ImageGrab |

## Quick Start

### Mac
```bash
# 1. Install Claude CLI first
npm install -g @anthropic-ai/claude-code
claude /login

# 2. Clone and run setup
git clone https://github.com/mrslothai/claudeeye.git
cd claudeeye
chmod +x install_mac.sh && ./install_mac.sh

# 3. Grant permissions when prompted (Screen Recording + Accessibility)

# 4. Run
python3 main.py
```

### Linux
```bash
git clone https://github.com/mrslothai/claudeeye.git
cd claudeeye
pip install -r requirements.txt
python3 main.py
```

### Windows
```bash
git clone https://github.com/mrslothai/claudeeye.git
cd claudeeye
pip install -r requirements.txt
python3 main.py
```

## Install (via pip)

```bash
pip install git+https://github.com/mrslothai/claudeeye.git
```

## Run

```bash
claudeeye
```

## Hotkey

`Ctrl + Shift + Space` — toggle window from anywhere

## How it works

1. Press `Ctrl+Shift+Space` or click tray icon
2. Type your question
3. ClaudeEye silently captures your screen
4. Claude sees what you see and responds

No copy-pasting errors. No manual screenshots. Just ask.

## Use cases

- Debug code errors without copy-pasting
- Get help on AWS console, Vercel, any web UI
- Explain what's on your screen to Claude
- Fix terminal errors instantly

---
Built by [@rajeshchityal](https://instagram.com/therajeshchityal)
