agenteye-app 1.0.0__py3-none-any.whl

agenteye_app-1.0.0.dist-info/METADATA

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: agenteye-app
+Version: 1.0.0
+Summary: Agent Eye dashboard for monitoring GitHub Copilot CLI sessions in real-time
+Home-page: https://github.com/JeffSteinbok/agenteye
+Author: Jeff Steinbok
+License: MIT
+Keywords: agenteye github cli dashboard session monitor
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi
+Requires-Dist: uvicorn
+Requires-Dist: platformdirs
+Requires-Dist: pywinauto; sys_platform == "win32"
+Requires-Dist: pywebview>=5.0
+Requires-Dist: pystray>=0.19
+Requires-Dist: pillow>=10.0
+Requires-Dist: plyer>=2.1
+Requires-Dist: pywin32; sys_platform == "win32"
+Requires-Dist: pywinauto; sys_platform == "win32"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Agent Eye
+[![GitHub](https://img.shields.io/badge/GitHub-agenteye-blue?logo=github)](https://github.com/JeffSteinbok/agenteye)
+[![GitHub release](https://img.shields.io/github/v/release/JeffSteinbok/agenteye)](https://github.com/JeffSteinbok/agenteye/releases)
+
+[![CI](https://github.com/JeffSteinbok/agenteye/actions/workflows/ci.yml/badge.svg)](https://github.com/JeffSteinbok/agenteye/actions/workflows/ci.yml)
+[![Release](https://github.com/JeffSteinbok/agenteye/actions/workflows/release.yml/badge.svg)](https://github.com/JeffSteinbok/agenteye/actions/workflows/release.yml)
+
+[![Publish to PyPI](https://github.com/JeffSteinbok/agenteye/actions/workflows/publish-pypi.yml/badge.svg)](https://github.com/JeffSteinbok/agenteye/actions/workflows/publish-pypi.yml)
+[![PyPI version](https://img.shields.io/pypi/v/agenteye.svg?v=0.3.2)](https://pypi.org/project/agenteye/)
+[![OpenAPI](https://img.shields.io/badge/OpenAPI-spec-green?logo=openapiinitiative)](https://editor.swagger.io/?url=https://raw.githubusercontent.com/JeffSteinbok/agenteye/main/docs/openapi.json)
+
+A local web dashboard that monitors all your GitHub Copilot CLI and Claude Code sessions in real-time.
+Designed for power users running multiple AI coding sessions simultaneously.
+
+> [!TIP]
+> The dashboard works out of the box by reading `events.jsonl` files from your Copilot session directories. For richer session history (summaries, checkpoints), enable the **SESSION_STORE** experimental feature: add `"experimental": true` to `~/.copilot/config.json` and start a new Copilot session.
+
+![Dashboard Screenshot](https://raw.githubusercontent.com/JeffSteinbok/agenteye/main/screenshot.png)
+
+## Installation
+
+### Option 1: From PyPI
+
+```bash
+pip install agenteye
+```
+
+### Option 2: From Source
+
+```bash
+# Clone the repo
+git clone https://github.com/JeffSteinbok/agenteye.git
+cd agenteye
+
+# Install in editable mode
+pip install -e .
+```
+
+## Usage
+
+### Native App (Recommended)
+
+Run as a native desktop app with system tray integration:
+
+```bash
+# Start the tray app (window + tray icon)
+agenteye app
+
+# Start minimized to tray
+agenteye app --hidden
+
+# Custom port
+agenteye app --port 8080
+```
+
+The tray app provides:
+- Native window with dark/light title bar matching app theme
+- System tray icon with quick access menu
+- Close (X) minimizes to tray, quit from tray menu exits
+- Native Windows notifications (no browser permission needed)
+
+### Browser Mode
+
+Run as a background server and open in your browser:
+
+```bash
+# Start the dashboard
+agenteye start
+
+# Start in background
+agenteye start --background
+
+# Check status
+agenteye status
+
+# Stop
+agenteye stop
+
+# Upgrade to the latest version (restarts automatically if running)
+agenteye upgrade
+```
+
+Open **http://localhost:5111** in your browser.
+
+### Autostart at Login (Windows)
+
+```bash
+# Start tray app on login (recommended)
+agenteye autostart --mode app
+
+# Start background server on login
+agenteye autostart --mode server
+
+# Custom port
+agenteye autostart --mode app --port 8080
+
+# Remove login startup
+agenteye autostart-remove
+```
+
+## Features
+
+### ✨ New in v0.10
+
+- **Native tray app** — `agenteye app` runs as a native desktop application with system tray integration, eliminating the need for a separate browser tab
+- **Dark/light title bar** — window title bar automatically matches your chosen theme
+- **Native notifications** — Windows toast notifications with proper app name and icon (no browser permission prompts)
+- **Start hidden** — `--hidden` flag starts the app minimized to tray (great for autostart)
+
+### ✨ New in v0.7
+
+- **Claude Code support** — automatically discovers Claude Code sessions from `~/.claude/projects/`. Active Claude sessions appear alongside Copilot sessions with a `✦ Claude` badge.
+- **Cross-machine sync** — see active sessions from all your machines in one dashboard, powered by OneDrive or any cloud-synced folder. See [Cross-Machine Sync](#cross-machine-sync) for details.
+- **Settings menu** — ☰ hamburger menu in the header with toggles for autostart-on-login and remote sync.
+- **Upgrade command** — `agenteye upgrade` stops the server, upgrades via pip, and restarts automatically.
+
+### Session States
+- **Working / Thinking** (green) — session is actively running tools or reasoning
+- **Waiting** (yellow) — session needs your input (`ask_user` or `ask_permission` pending)
+- **Idle** (blue) — session is done and ready for your next task
+
+### Key Features
+- **Desktop notifications** — get alerts when sessions transition between states
+- **Focus window** — bring an active session's terminal to the foreground with one click
+- **Restart commands** — copy-pasteable `copilot --resume <id>` commands for every session
+- **Waiting context** — shows *what* a waiting session is asking (e.g. the `ask_user` question and choices)
+- **Background tasks** — shows count of running subagents per session
+- **Session details** — click any session to see checkpoints, recent tool output, references, and conversation history
+- **Tile & List views** — compact card grid or detailed expandable rows
+- **9 color palettes** and light/dark mode
+
+### Cross-Machine Sync
+
+See active sessions from all your machines in one dashboard — powered by OneDrive, Google Drive, or any cloud-synced folder. No Git commits needed.
+
+**How it works:**
+- On each poll cycle, the dashboard exports your active sessions as JSON files to a shared cloud folder
+- Other machines read those files and display them in a **"Remote Sessions"** section under Active
+- Each machine only writes to its own subfolder — no sync conflicts
+
+**Auto-detection (priority order):**
+1. `OneDriveCommercial` (preferred — prevents data leakage to personal accounts)
+2. `OneDriveConsumer`
+3. User Documents folder
+
+**Configuration** (`~/.copilot/dashboard-config.json`):
+```json
+{
+  "sync": {
+    "enabled": true,
+    "folder": "D:\\MyCloudSync"
+  }
+}
+```
+- Set `"enabled": false` to disable sync entirely
+- Set `"folder"` to override auto-detection with a specific path
+
+**What remote sessions show:**
+- Live state indicators (working, waiting, idle)
+- Session summary, intent, branch, MCP servers, turn/checkpoint counts
+- Machine name badge (e.g. `🖥️ LAPTOP-HOME`)
+
+**What remote sessions don't show:**
+- No detail drill-down (checkpoints, turns, files)
+- No focus or kill actions (those are local-only)
+- No past/previous sessions from remote machines
+
+## Prerequisites
+
+| Package | Purpose |
+|---------|---------|
+| `fastapi` | Web framework with auto-generated OpenAPI docs |
+| `uvicorn` | ASGI server |
+| `pywinauto` | Window focus and process detection (Windows-only) |
+| `pywebview` | Native window for tray app |
+| `pystray` | System tray icon |
+| `plyer` | Native OS notifications |
+
+All are installed automatically via `pip install agenteye`.
+
+For more details on architecture, data sources, and API endpoints, see [DEVELOPMENT.md](DEVELOPMENT.md).

agenteye_app-1.0.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+agenteye_app-1.0.0.dist-info/licenses/LICENSE,sha256=G3FOOzsWqAlBInxvfL_9l07d0RboFDbiylFfzHazaHU,1070
+src/__init__.py,sha256=mlQ3hizYy6nFYBKUGbFfc_ub1IxJCD3_vuBgrIPN6T4,165
+src/__version__.py,sha256=3VzAZYCI4yP1n8P_j_IrrEB7AfzMkXGVbXiIiPMQB-w,124
+src/claude_code.py,sha256=qZOlafbLU-zOT_bjDJrW0uWpBNdyxOmOFzFEkt6_sQg,20283
+src/constants.py,sha256=xb0E9wNovWi2KdYRQEeglnd4az4XCXPfMWpsIz9drFM,8527
+src/dashboard_api.py,sha256=B3JZIHZP7IirTBGnDWoYYyfy1fBSHtKeQBTQP9-ZOIk,37302
+src/grouping.py,sha256=kJ7wC-sXGdEMFIyNn7qx4EHDjCyR37na6Yhp8Yw_4hQ,3596
+src/logging_config.py,sha256=czOHPd80mu7TzXmKLVm0PNrWambMMWaAX0QJNU7ZwaI,3893
+src/models.py,sha256=Jng_67IL7EW4IpMHQ1p3klpGSqjk-Xe_Iu9QsmDiS0Y,1643
+src/process_tracker.py,sha256=SkL66PIDmXbaF0_0gIramSw0XgDvuNe7nLVb6W1YOqY,47380
+src/schemas.py,sha256=cte7amm5Ob8Pr2sQbLtq15GzmGfKNaXJ-ZJNFYLNn_U,4524
+src/session_dashboard.py,sha256=wJXNwn2IjbdbWevSgkcP0kyngaTmFa0Wx2Ejxd96Luk,23031
+src/sync.py,sha256=b_Av6--AnRV4mjrHxNkleTgoxnmMBwlVBrkuGkib4Ao,9077
+src/tray_app.py,sha256=ak1W1ZIRgJVpjTkenEl6jMihHldWZpq6x_DnX08PR0I,19214
+src/static/favicon.png,sha256=ndq8F2F0yln1_VqbyKP2-5wD-HtzwyfE7mbDP28dyhU,5162
+src/static/icon-192.png,sha256=LJ-ZwoxQGX4BLpQe9DU6iq4wS3FKHVZhym-uTVKE_eg,27741
+src/static/icon-512.png,sha256=K8Kq2w_pKhTPxDsbY3KEasrRea0jAxFGlOzcVC9XmKQ,163471
+src/static/logo.png,sha256=umOB8Hh5POqmgNdFCcNvLeINN_nm3QSPq4hSDRva4ds,759027
+src/static/tray-icon.ico,sha256=B0bRAx_JHx7diV6E8TWPpd1MoCVurIaFZCXaNoCcs3E,72021
+src/static/tray-icon.png,sha256=XD9jzkC8BE1hso1SWjh3QTKo3nlkpTqUQyPN8mnm6e4,44606
+src/static/trayTemplate.png,sha256=k81OWVWCcZeCY4VfwqfMKc1CJY4bi3j-soHj9FmZe_8,26036
+src/static/dist/index.html,sha256=b4xrHqVmlLH8hes16WSOvtOmudrAFC-eEzI9UVx_Z80,1328
+src/static/dist/assets/index-BDgkVPoS.js,sha256=EF_ec0vNYcyjR_0MMJtrMqGdZvPSChziJriDk7VvlYY,194334
+src/static/dist/assets/index-BDgkVPoS.js.map,sha256=NHR-Z4i4_D-ZR3BiSYm43PsyV9YGPJiQwHVoV_C-ksc,536225
+src/static/dist/assets/index-BSoxjIF8.css,sha256=Z47bYTpe-Ec0su0G1MwuybVS_QJDHJCiY8QTvk-sa8M,24381
+agenteye_app-1.0.0.dist-info/METADATA,sha256=byGqax4Xw4CilBC31OlXbl6JBcjmbQawINBRw6BZS8o,8360
+agenteye_app-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agenteye_app-1.0.0.dist-info/entry_points.txt,sha256=2dTIjpEXtRjpEnmDmV3UTjy8URbl1IhxM6TaCmCk7_c,56
+agenteye_app-1.0.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+agenteye_app-1.0.0.dist-info/RECORD,,

agenteye_app-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agenteye_app-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agenteye = src.session_dashboard:main

agenteye_app-1.0.0.dist-info/licenses/LICENSE

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

agenteye_app-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+src

src/__init__.py

@@ -0,0 +1,5 @@
+"""Agent Eye — monitor all your GitHub Copilot CLI sessions."""
+
+from .__version__ import __repository__, __version__
+
+__all__ = ["__repository__", "__version__"]

src/__version__.py

@@ -0,0 +1,4 @@
+"""Version information for Agent Eye."""
+
+__version__ = "1.0.0"
+__repository__ = "https://github.com/JeffSteinbok/agenteye"