Skip to main content

ClaudeEye 👁

Install

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

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

# 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

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

Windows

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

Install (via pip)

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

Run

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

Metadata

Release files for claudeeye 1.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for claudeeye 1.9.0
File Size Uploaded
claudeeye-1.9.0.tar.gz 14.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for claudeeye 1.9.0
File Interpreter ABI Platform
claudeeye-1.9.0-py3-none-any.whl Python 3 none any Details

Total release size: 30.7 kB

Release files / claudeeye-1.9.0.tar.gz

Download URL claudeeye-1.9.0.tar.gz
Size 14.9 kB
Tags Source
SHA-256 checksum
How to use checksums
977a144df4a400f028e94bd2aa49a09a1f952ad8a89cb0e3a3a1e8313994bde4
BLAKE2b-256 checksum
How to use checksums
fb62c775cc7be96aaf651059032272c1ec80536ce110b9e5eac23e9be8ed1d41
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / claudeeye-1.9.0-py3-none-any.whl

Download URL claudeeye-1.9.0-py3-none-any.whl
Size 15.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
15290c148c4627e6897f174abc4b81eb9fdb9f7af29095fde0425fde739f1583
BLAKE2b-256 checksum
How to use checksums
880379e12b9fc08113a3b3a6edb31f1e3fa7c34964fb74b19889aae6bead830a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

1.9.0 This release

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.0

2 release files

1.5.0

2 release files

1.4.0

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page