gitglimpse 0.1.4__tar.gz → 0.1.5__tar.gz

gitglimpse-0.1.5/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: gitglimpse
+Version: 0.1.5
+Summary: Extract structured context from your git history — PR descriptions, standups, weekly reports, and LLM-ready JSON.
+Project-URL: Homepage, https://github.com/dino/gitglimpse
+Project-URL: Repository, https://github.com/dino/gitglimpse
+Project-URL: Bug Tracker, https://github.com/dino/gitglimpse/issues
+Author: Dino
+License: MIT
+License-File: LICENSE
+Keywords: cli,developer-tools,git,standup
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli-w>=1.2
+Requires-Dist: typer[all]>=0.9.0
+Provides-Extra: llm
+Requires-Dist: httpx>=0.27; extra == 'llm'
+Description-Content-Type: text/markdown
+
+# gitglimpse
+
+Extract structured context from your git history — PR descriptions, standups, weekly reports, and LLM-ready JSON.
+
+## Install
+
+```bash
+pip install gitglimpse
+```
+
+## What it does
+
+gitglimpse reads your git log, groups commits into logical tasks, filters noise, extracts ticket IDs from branch names, and outputs structured context — as formatted text or clean JSON.
+
+## Commands
+
+```bash
+glimpse pr                          # PR summary from current branch
+glimpse standup                     # daily context from recent commits
+glimpse week                        # weekly summary grouped by day
+glimpse report                      # markdown report with file details
+glimpse init                        # generate Claude Code / Cursor slash commands
+glimpse config setup                # interactive configuration
+```
+
+## Features
+
+- **Noise filtering** — merge commits, lock files, and formatting changes excluded by default
+- **Ticket detection** — branch names like `feature/PROJ-123` are parsed automatically
+- **Multi-project** — run from a parent directory to aggregate across repos
+- **LLM-optional** — works instantly without AI, or connect Ollama / OpenAI / Anthropic / Gemini for richer output
+- **Editor integration** — slash commands for Claude Code and Cursor
+- **GitHub Action** — auto-generate PR context on every pull request
+- **JSON output** — every command supports `--json` for pipelines and LLM workflows
+
+## Links
+
+- **Website:** [gitglimpse.com](https://gitglimpse.com)
+- **GitHub:** [github.com/dino-zecevic/gitglimpse](https://github.com/dino-zecevic/gitglimpse)
+- **Documentation:** [README on GitHub](https://github.com/dino-zecevic/gitglimpse#readme)
+
+## License
+
+MIT

gitglimpse-0.1.5/PYPI_README.md

@@ -0,0 +1,44 @@
+# gitglimpse
+
+Extract structured context from your git history — PR descriptions, standups, weekly reports, and LLM-ready JSON.
+
+## Install
+
+```bash
+pip install gitglimpse
+```
+
+## What it does
+
+gitglimpse reads your git log, groups commits into logical tasks, filters noise, extracts ticket IDs from branch names, and outputs structured context — as formatted text or clean JSON.
+
+## Commands
+
+```bash
+glimpse pr                          # PR summary from current branch
+glimpse standup                     # daily context from recent commits
+glimpse week                        # weekly summary grouped by day
+glimpse report                      # markdown report with file details
+glimpse init                        # generate Claude Code / Cursor slash commands
+glimpse config setup                # interactive configuration
+```
+
+## Features
+
+- **Noise filtering** — merge commits, lock files, and formatting changes excluded by default
+- **Ticket detection** — branch names like `feature/PROJ-123` are parsed automatically
+- **Multi-project** — run from a parent directory to aggregate across repos
+- **LLM-optional** — works instantly without AI, or connect Ollama / OpenAI / Anthropic / Gemini for richer output
+- **Editor integration** — slash commands for Claude Code and Cursor
+- **GitHub Action** — auto-generate PR context on every pull request
+- **JSON output** — every command supports `--json` for pipelines and LLM workflows
+
+## Links
+
+- **Website:** [gitglimpse.com](https://gitglimpse.com)
+- **GitHub:** [github.com/dino-zecevic/gitglimpse](https://github.com/dino-zecevic/gitglimpse)
+- **Documentation:** [README on GitHub](https://github.com/dino-zecevic/gitglimpse#readme)
+
+## License
+
+MIT

{gitglimpse-0.1.4 → gitglimpse-0.1.5}/pyproject.toml

@@ -4,9 +4,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gitglimpse"
-version = "0.1.4"
+version = "0.1.5"
 description = "Extract structured context from your git history — PR descriptions, standups, weekly reports, and LLM-ready JSON."
-readme = "README.md"
+readme = "PYPI_README.md"
 authors = [{ name = "Dino" }]
 license = { text = "MIT" }
 requires-python = ">=3.11"
@@ -25,13 +25,14 @@ dependencies = [
     "InquirerPy>=0.3.4",
 ]
 
+[project.optional-dependencies]
+llm = ["httpx>=0.27"]
+
 [project.urls]
 Homepage = "https://github.com/dino/gitglimpse"
 Repository = "https://github.com/dino/gitglimpse"
 "Bug Tracker" = "https://github.com/dino/gitglimpse/issues"
 
-[project.optional-dependencies]
-llm = ["httpx>=0.27"]
 
 [project.scripts]
 glimpse = "gitglimpse.cli:app"

gitglimpse-0.1.5/src/gitglimpse/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.5"

{gitglimpse-0.1.4 → gitglimpse-0.1.5}/src/gitglimpse/cli.py

@@ -18,7 +18,6 @@ from gitglimpse.formatters.template import format_standup, format_week_template
 from gitglimpse.git import GitError, get_branch_commits, get_commit_diff, get_commits, get_current_branch_name
 from gitglimpse.grouping import filter_noise_commits, group_commits_into_tasks, is_vague_message
 from gitglimpse.providers import get_provider
-from gitglimpse.providers.local import LocalProvider
 
 app = typer.Typer(
     name="glimpse",
@@ -276,6 +275,7 @@ def _print_status_line(
         ctx_mode: str = "commits",
 ) -> None:
     """Print a one-line dim status showing author, context, and active model."""
+    from gitglimpse.providers.local import LocalProvider
     from gitglimpse.providers.openai import OpenAIProvider
     from gitglimpse.providers.claude import ClaudeProvider
     from gitglimpse.providers.gemini import GeminiProvider
@@ -315,6 +315,8 @@ def _resolve_provider(
       2. config default_mode == local-llm / api → get_provider()
       3. anything else → None (template fallback)
     """
+    from gitglimpse.providers.local import LocalProvider
+
     if use_local:
         url = local_url_override or cfg.local_llm_url
         model = model_override or cfg.llm_model or None
@@ -457,6 +459,7 @@ def standup(
     active_provider: object | None = None
     llm_output: str | None = None
     if not no_llm:
+        from gitglimpse.providers.local import LocalProvider
         provider = _resolve_provider(cfg, local_llm, local_llm_url, model, context_mode=ctx_mode)
         if provider is not None:
             if isinstance(provider, LocalProvider) and not provider.is_available():
@@ -602,6 +605,7 @@ def week(
     active_provider: object | None = None
     llm_output: str | None = None
     if not no_llm:
+        from gitglimpse.providers.local import LocalProvider
         provider = _resolve_provider(cfg, local_llm, local_llm_url, model, context_mode=ctx_mode)
         if provider is not None:
             if isinstance(provider, LocalProvider) and not provider.is_available():
@@ -733,6 +737,7 @@ def pr(
     active_provider: object | None = None
     llm_output: str | None = None
     if not no_llm:
+        from gitglimpse.providers.local import LocalProvider
         provider = _resolve_provider(cfg, local_llm, local_llm_url, model, context_mode=ctx_mode)
         if provider is not None:
             if isinstance(provider, LocalProvider) and not provider.is_available():

{gitglimpse-0.1.4 → gitglimpse-0.1.5}/src/gitglimpse/providers/claude.py

@@ -5,8 +5,6 @@ from __future__ import annotations
 from datetime import date
 from typing import TYPE_CHECKING
 
-import httpx
-
 from gitglimpse.providers.base import BaseLLMProvider, _warn, validate_llm_output
 
 if TYPE_CHECKING:
@@ -14,9 +12,18 @@ if TYPE_CHECKING:
 
 _API_URL = "https://api.anthropic.com/v1/messages"
 _ANTHROPIC_VERSION = "2023-06-01"
-_TIMEOUT = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
 _MAX_TOKENS = 1024
 
+_HTTPX_INSTALL_HINT = "httpx is required for LLM features. Install with: pip install 'gitglimpse[llm]'"
+
+
+def _import_httpx():
+    try:
+        import httpx
+        return httpx
+    except ImportError:
+        raise ImportError(_HTTPX_INSTALL_HINT)
+
 
 class ClaudeProvider(BaseLLMProvider):
     """Anthropic Claude messages provider."""
@@ -27,6 +34,7 @@ class ClaudeProvider(BaseLLMProvider):
         self.context_mode = context_mode
 
     def _chat(self, user_message: str, system_prompt: str | None = None) -> str | None:
+        httpx = _import_httpx()
         if system_prompt is None:
             system_prompt = self.get_system_prompt()
         headers = {
@@ -40,9 +48,10 @@ class ClaudeProvider(BaseLLMProvider):
             "system": system_prompt,
             "messages": [{"role": "user", "content": user_message}],
         }
+        _timeout = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
         try:
             with _warn.status(f"[dim]Generating with {self.model}...[/dim]"):
-                resp = httpx.post(_API_URL, json=payload, headers=headers, timeout=_TIMEOUT)
+                resp = httpx.post(_API_URL, json=payload, headers=headers, timeout=_timeout)
             if resp.status_code == 401:
                 _warn.print("[yellow]⚠ Claude: invalid API key.[/yellow]")
                 return None

{gitglimpse-0.1.4 → gitglimpse-0.1.5}/src/gitglimpse/providers/gemini.py

@@ -5,15 +5,22 @@ from __future__ import annotations
 from datetime import date
 from typing import TYPE_CHECKING
 
-import httpx
-
 from gitglimpse.providers.base import BaseLLMProvider, _warn, validate_llm_output
 
 if TYPE_CHECKING:
     from gitglimpse.grouping import Task
 
 _API_BASE = "https://generativelanguage.googleapis.com/v1beta/models"
-_TIMEOUT = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
+
+_HTTPX_INSTALL_HINT = "httpx is required for LLM features. Install with: pip install 'gitglimpse[llm]'"
+
+
+def _import_httpx():
+    try:
+        import httpx
+        return httpx
+    except ImportError:
+        raise ImportError(_HTTPX_INSTALL_HINT)
 
 
 class GeminiProvider(BaseLLMProvider):
@@ -25,6 +32,7 @@ class GeminiProvider(BaseLLMProvider):
         self.context_mode = context_mode
 
     def _chat(self, user_message: str, system_prompt: str | None = None) -> str | None:
+        httpx = _import_httpx()
         if system_prompt is None:
             system_prompt = self.get_system_prompt()
         url = f"{_API_BASE}/{self.model}:generateContent?key={self.api_key}"
@@ -36,9 +44,10 @@ class GeminiProvider(BaseLLMProvider):
                 {"parts": [{"text": user_message}]}
             ],
         }
+        _timeout = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
         try:
             with _warn.status(f"[dim]Generating with {self.model}...[/dim]"):
-                resp = httpx.post(url, json=payload, timeout=_TIMEOUT)
+                resp = httpx.post(url, json=payload, timeout=_timeout)
             if resp.status_code == 400:
                 _warn.print("[yellow]⚠ Gemini: bad request (check API key or model name).[/yellow]")
                 return None

{gitglimpse-0.1.4 → gitglimpse-0.1.5}/src/gitglimpse/providers/local.py

@@ -5,8 +5,6 @@ from __future__ import annotations
 from datetime import date
 from typing import TYPE_CHECKING
 
-import httpx
-
 from gitglimpse.providers.base import BaseLLMProvider, _warn, validate_llm_output
 
 if TYPE_CHECKING:
@@ -17,6 +15,16 @@ _READ_TIMEOUT = 240.0
 _AVAILABILITY_TIMEOUT = 3.0
 _DEFAULT_MODEL = "qwen2.5-coder:latest"
 
+_HTTPX_INSTALL_HINT = "httpx is required for LLM features. Install with: pip install 'gitglimpse[llm]'"
+
+
+def _import_httpx():
+    try:
+        import httpx
+        return httpx
+    except ImportError:
+        raise ImportError(_HTTPX_INSTALL_HINT)
+
 
 class LocalProvider(BaseLLMProvider):
     """OpenAI-compatible local LLM (Ollama, LM Studio, etc.)."""
@@ -27,6 +35,7 @@ class LocalProvider(BaseLLMProvider):
         model: str | None = None,
         context_mode: str = "commits",
     ) -> None:
+        httpx = _import_httpx()
         self.base_url = base_url.rstrip("/")
         self._explicit_model = model
         self._model_resolved = bool(model)
@@ -41,6 +50,7 @@ class LocalProvider(BaseLLMProvider):
 
     def is_available(self) -> bool:
         """Return True if the local server responds to a quick probe."""
+        httpx = _import_httpx()
         try:
             resp = httpx.get(
                 f"{self.base_url}/models",
@@ -55,6 +65,7 @@ class LocalProvider(BaseLLMProvider):
         if self._model_resolved:
             return
         self._model_resolved = True
+        httpx = _import_httpx()
         try:
             resp = httpx.get(
                 f"{self.base_url}/models",
@@ -68,6 +79,7 @@ class LocalProvider(BaseLLMProvider):
             pass  # keep the default
 
     def _chat(self, user_message: str, system_prompt: str | None = None) -> str | None:
+        httpx = _import_httpx()
         self._auto_detect_model()
         url = f"{self.base_url}/chat/completions"
         if system_prompt is None:

{gitglimpse-0.1.4 → gitglimpse-0.1.5}/src/gitglimpse/providers/openai.py

@@ -5,15 +5,22 @@ from __future__ import annotations
 from datetime import date
 from typing import TYPE_CHECKING
 
-import httpx
-
 from gitglimpse.providers.base import BaseLLMProvider, _warn, validate_llm_output
 
 if TYPE_CHECKING:
     from gitglimpse.grouping import Task
 
 _API_URL = "https://api.openai.com/v1/chat/completions"
-_TIMEOUT = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
+
+_HTTPX_INSTALL_HINT = "httpx is required for LLM features. Install with: pip install 'gitglimpse[llm]'"
+
+
+def _import_httpx():
+    try:
+        import httpx
+        return httpx
+    except ImportError:
+        raise ImportError(_HTTPX_INSTALL_HINT)
 
 
 class OpenAIProvider(BaseLLMProvider):
@@ -25,6 +32,7 @@ class OpenAIProvider(BaseLLMProvider):
         self.context_mode = context_mode
 
     def _chat(self, user_message: str, system_prompt: str | None = None) -> str | None:
+        httpx = _import_httpx()
         if system_prompt is None:
             system_prompt = self.get_system_prompt()
         headers = {
@@ -38,9 +46,10 @@ class OpenAIProvider(BaseLLMProvider):
                 {"role": "user", "content": user_message},
             ],
         }
+        _timeout = httpx.Timeout(connect=30.0, read=120.0, write=30.0, pool=30.0)
         try:
             with _warn.status(f"[dim]Generating with {self.model}...[/dim]"):
-                resp = httpx.post(_API_URL, json=payload, headers=headers, timeout=_TIMEOUT)
+                resp = httpx.post(_API_URL, json=payload, headers=headers, timeout=_timeout)
             if resp.status_code == 401:
                 _warn.print("[yellow]⚠ OpenAI: invalid API key.[/yellow]")
                 return None

gitglimpse-0.1.4/PKG-INFO

@@ -1,391 +0,0 @@
-Metadata-Version: 2.4
-Name: gitglimpse
-Version: 0.1.4
-Summary: Extract structured context from your git history — PR descriptions, standups, weekly reports, and LLM-ready JSON.
-Project-URL: Homepage, https://github.com/dino/gitglimpse
-Project-URL: Repository, https://github.com/dino/gitglimpse
-Project-URL: Bug Tracker, https://github.com/dino/gitglimpse/issues
-Author: Dino
-License: MIT
-License-File: LICENSE
-Keywords: cli,developer-tools,git,standup
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.11
-Requires-Dist: inquirerpy>=0.3.4
-Requires-Dist: platformdirs>=4.0
-Requires-Dist: rich>=13.0
-Requires-Dist: tomli-w>=1.2
-Requires-Dist: typer[all]>=0.9.0
-Provides-Extra: llm
-Requires-Dist: httpx>=0.27; extra == 'llm'
-Description-Content-Type: text/markdown
-
-<div align="center">
-
-<img src="docs/gitglimpse.png" alt="gitglimpse" width="120">
-
-# gitglimpse
-
-**Extract structured context from your git history. Standups, PR descriptions, weekly reports, and LLM-ready JSON — from one command.**
-
-50KB of raw diffs → 1KB of structured signal. Less noise, fewer tokens, better output.
-
-[![Python 3.11+](https://img.shields.io/badge/python-3.11+-3776AB?logo=python&logoColor=white)](https://python.org)
-[![License: MIT](https://img.shields.io/badge/license-MIT-F59E0B)](LICENSE)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](CONTRIBUTING.md)
-
-<br>
-
-</div>
-
----
-
-## Why gitglimpse?
-
-Modern development (especially with AI) creates **more changes across more files than ever**.
-
-Git tracks *what changed* — but not in a way that's easy to understand quickly.
-
-gitglimpse bridges that gap.
-
-It turns raw git history into:
-
-- 🧠 **Structured context (JSON)** for LLMs and tools  
-- 📝 **Standups & reports** for humans  
-- 🔍 **Clean summaries** without opening diffs or PRs  
-
-> Think of it as a **context extraction layer for your codebase**.
-
----
-
-## ✨ Demo
-
-<!-- TODO: Replace with real GIF -->
-![Standup Demo](docs/demo-standup.gif)
-
----
-
-## Quick Start
-
-```bash
-pip install gitglimpse
-cd your-project
-glimpse standup
-````
-
-That’s it. No API keys, no setup required.
-
----
-
-## Core Idea
-
-gitglimpse is not just a “standup generator”.
-
-It’s a **Git → Structured Context engine**.
-
-```bash
-glimpse standup --json | your-llm
-```
-
-Instead of dumping raw diffs into an LLM, you give it:
-
-* grouped tasks
-* extracted tickets
-* filtered noise
-* optional diffs
-* structured JSON
-
----
-
-## 🚀 Commands
-
-### `glimpse pr`
-
-Generate PR summaries from your branch.
-
-```bash
-glimpse pr
-glimpse pr --json
-glimpse pr --base develop
-```
-
----
-
-### `glimpse standup`
-
-Generate a daily summary or structured context.
-
-```bash
-glimpse standup
-glimpse standup --json
-glimpse standup --since "3 days ago"
-glimpse standup --format markdown
-```
-
-Example:
-
-```
-Yesterday:
-  • Add rate limiting middleware (AUTH-42, ~1.5h)
-  • Fix pagination bug (BUG-87, ~1h)
-
-Estimated effort: 2.5h
-```
-
----
-
-### `glimpse week`
-
-Weekly breakdown grouped by day.
-
-```bash
-glimpse week
-glimpse week --json
-```
-
----
-
-### `glimpse init`
-
-Install Claude Code / Cursor slash commands.
-
-```bash
-glimpse init
-```
-
-Then in your editor:
-
-```
-/standup
-/pr
-/week
-```
-
----
-
-### `glimpse config`
-
-View or edit configuration.
-
-```bash
-glimpse config show
-glimpse config setup
-```
-
----
-
-## 🧩 Output Modes
-
-| Mode          | Description                     |
-| ------------- | ------------------------------- |
-| **Template**  | Fast, deterministic, no LLM     |
-| **Local LLM** | Uses Ollama (privacy-first)     |
-| **Cloud API** | OpenAI / Anthropic / Gemini     |
-| **JSON**      | Structured output for pipelines |
-
----
-
-## 🔥 What Makes It Different
-
-### 1. Noise Filtering (by default)
-
-Removes:
-
-* merge commits
-* lock files
-* formatting changes
-
-So you only see meaningful work.
-
----
-
-### 2. Task Grouping
-
-Commits → grouped into **real tasks**:
-
-```
-3 commits → 1 task
-```
-
----
-
-### 3. Ticket Extraction
-
-Automatically parses:
-
-```
-feature/AUTH-42-login → AUTH-42
-```
-
----
-
-### 4. Works Without LLMs
-
-No AI required.
-
-* Good commits → good summaries
-* Bad commits → fallback heuristics
-* LLM → optional enhancement
-
----
-
-### 5. Built for LLM Workflows
-
-Instead of:
-
-```bash
-git diff | llm
-```
-
-You do:
-
-```bash
-glimpse standup --json | llm
-```
-
-Cleaner input → better output.
-
----
-
-## 🤖 Claude Code Integration
-
-<!-- TODO: Add GIF showing /standup usage -->
-
-```bash
-glimpse init
-git add .claude/commands/
-git commit -m "add glimpse commands"
-```
-
-Now every dev on your team gets:
-
-```
-/standup
-/pr
-/week
-```
-
-📌 The repo becomes the distribution channel.
-
----
-
-## GitHub Action
-
-Add automatic PR context to your repository:
-
-```yaml
-- uses: dino-zecevic/gitglimpse@main
-  with:
-    github-token: ${{ secrets.GITHUB_TOKEN }}
-```
-
-Every pull request gets a structured summary with changes, ticket IDs, and effort estimates. The comment updates on each push.
-
-See [action/README.md](action/README.md) for full configuration options.
-
----
-
-## 🧠 Multi-Project Mode
-
-Run from a parent folder:
-
-```bash
-cd ~/projects
-glimpse standup
-```
-
-gitglimpse will:
-
-* detect repos automatically
-* merge timelines
-* group by project or task
-
-<!-- TODO: Add multi-project GIF -->
-
----
-
-## ⚙️ Configuration
-
-```bash
-glimpse config setup
-```
-
-Stored in:
-
-```
-~/.config/gitglimpse/config.toml
-```
-
-Supports:
-
-* local models (Ollama)
-* cloud APIs
-* context modes (`commits`, `diffs`, `both`)
-
----
-
-## Philosophy
-
-* **Privacy-first** — works fully offline
-* **LLM-optional** — useful without AI
-* **Developer-first** — not a manager tool
-* **Composable** — JSON output for pipelines
-* **Honest** — no fake precision (effort is approximate)
-
----
-
-## When It’s Actually Useful
-
-* Weekly summaries across repos
-* PR descriptions
-* Feeding context into coding agents
-* Remembering what you did yesterday
-
----
-
-## ⚠️ Limitations
-
-* Only sees **code changes** (not meetings, docs, etc.)
-* Effort estimation is **heuristic, not accurate**
-* Depends on git history quality
-
----
-
-## Installation
-
-```bash
-pip install gitglimpse
-```
-
-Requirements:
-
-* Python 3.11+
-* git
-* (optional) Ollama or API key
-
----
-
-## Contributing
-
-PRs welcome — especially for:
-
-* better effort estimation
-* smarter task grouping
-* improved noise filtering
-
----
-
-## License
-
-MIT
-
----
-
-<div align="center">
-
-Built by Dino
-
-</div>

gitglimpse-0.1.4/README.md

@@ -1,366 +0,0 @@
-<div align="center">
-
-<img src="docs/gitglimpse.png" alt="gitglimpse" width="120">
-
-# gitglimpse
-
-**Extract structured context from your git history. Standups, PR descriptions, weekly reports, and LLM-ready JSON — from one command.**
-
-50KB of raw diffs → 1KB of structured signal. Less noise, fewer tokens, better output.
-
-[![Python 3.11+](https://img.shields.io/badge/python-3.11+-3776AB?logo=python&logoColor=white)](https://python.org)
-[![License: MIT](https://img.shields.io/badge/license-MIT-F59E0B)](LICENSE)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](CONTRIBUTING.md)
-
-<br>
-
-</div>
-
----
-
-## Why gitglimpse?
-
-Modern development (especially with AI) creates **more changes across more files than ever**.
-
-Git tracks *what changed* — but not in a way that's easy to understand quickly.
-
-gitglimpse bridges that gap.
-
-It turns raw git history into:
-
-- 🧠 **Structured context (JSON)** for LLMs and tools  
-- 📝 **Standups & reports** for humans  
-- 🔍 **Clean summaries** without opening diffs or PRs  
-
-> Think of it as a **context extraction layer for your codebase**.
-
----
-
-## ✨ Demo
-
-<!-- TODO: Replace with real GIF -->
-![Standup Demo](docs/demo-standup.gif)
-
----
-
-## Quick Start
-
-```bash
-pip install gitglimpse
-cd your-project
-glimpse standup
-````
-
-That’s it. No API keys, no setup required.
-
----
-
-## Core Idea
-
-gitglimpse is not just a “standup generator”.
-
-It’s a **Git → Structured Context engine**.
-
-```bash
-glimpse standup --json | your-llm
-```
-
-Instead of dumping raw diffs into an LLM, you give it:
-
-* grouped tasks
-* extracted tickets
-* filtered noise
-* optional diffs
-* structured JSON
-
----
-
-## 🚀 Commands
-
-### `glimpse pr`
-
-Generate PR summaries from your branch.
-
-```bash
-glimpse pr
-glimpse pr --json
-glimpse pr --base develop
-```
-
----
-
-### `glimpse standup`
-
-Generate a daily summary or structured context.
-
-```bash
-glimpse standup
-glimpse standup --json
-glimpse standup --since "3 days ago"
-glimpse standup --format markdown
-```
-
-Example:
-
-```
-Yesterday:
-  • Add rate limiting middleware (AUTH-42, ~1.5h)
-  • Fix pagination bug (BUG-87, ~1h)
-
-Estimated effort: 2.5h
-```
-
----
-
-### `glimpse week`
-
-Weekly breakdown grouped by day.
-
-```bash
-glimpse week
-glimpse week --json
-```
-
----
-
-### `glimpse init`
-
-Install Claude Code / Cursor slash commands.
-
-```bash
-glimpse init
-```
-
-Then in your editor:
-
-```
-/standup
-/pr
-/week
-```
-
----
-
-### `glimpse config`
-
-View or edit configuration.
-
-```bash
-glimpse config show
-glimpse config setup
-```
-
----
-
-## 🧩 Output Modes
-
-| Mode          | Description                     |
-| ------------- | ------------------------------- |
-| **Template**  | Fast, deterministic, no LLM     |
-| **Local LLM** | Uses Ollama (privacy-first)     |
-| **Cloud API** | OpenAI / Anthropic / Gemini     |
-| **JSON**      | Structured output for pipelines |
-
----
-
-## 🔥 What Makes It Different
-
-### 1. Noise Filtering (by default)
-
-Removes:
-
-* merge commits
-* lock files
-* formatting changes
-
-So you only see meaningful work.
-
----
-
-### 2. Task Grouping
-
-Commits → grouped into **real tasks**:
-
-```
-3 commits → 1 task
-```
-
----
-
-### 3. Ticket Extraction
-
-Automatically parses:
-
-```
-feature/AUTH-42-login → AUTH-42
-```
-
----
-
-### 4. Works Without LLMs
-
-No AI required.
-
-* Good commits → good summaries
-* Bad commits → fallback heuristics
-* LLM → optional enhancement
-
----
-
-### 5. Built for LLM Workflows
-
-Instead of:
-
-```bash
-git diff | llm
-```
-
-You do:
-
-```bash
-glimpse standup --json | llm
-```
-
-Cleaner input → better output.
-
----
-
-## 🤖 Claude Code Integration
-
-<!-- TODO: Add GIF showing /standup usage -->
-
-```bash
-glimpse init
-git add .claude/commands/
-git commit -m "add glimpse commands"
-```
-
-Now every dev on your team gets:
-
-```
-/standup
-/pr
-/week
-```
-
-📌 The repo becomes the distribution channel.
-
----
-
-## GitHub Action
-
-Add automatic PR context to your repository:
-
-```yaml
-- uses: dino-zecevic/gitglimpse@main
-  with:
-    github-token: ${{ secrets.GITHUB_TOKEN }}
-```
-
-Every pull request gets a structured summary with changes, ticket IDs, and effort estimates. The comment updates on each push.
-
-See [action/README.md](action/README.md) for full configuration options.
-
----
-
-## 🧠 Multi-Project Mode
-
-Run from a parent folder:
-
-```bash
-cd ~/projects
-glimpse standup
-```
-
-gitglimpse will:
-
-* detect repos automatically
-* merge timelines
-* group by project or task
-
-<!-- TODO: Add multi-project GIF -->
-
----
-
-## ⚙️ Configuration
-
-```bash
-glimpse config setup
-```
-
-Stored in:
-
-```
-~/.config/gitglimpse/config.toml
-```
-
-Supports:
-
-* local models (Ollama)
-* cloud APIs
-* context modes (`commits`, `diffs`, `both`)
-
----
-
-## Philosophy
-
-* **Privacy-first** — works fully offline
-* **LLM-optional** — useful without AI
-* **Developer-first** — not a manager tool
-* **Composable** — JSON output for pipelines
-* **Honest** — no fake precision (effort is approximate)
-
----
-
-## When It’s Actually Useful
-
-* Weekly summaries across repos
-* PR descriptions
-* Feeding context into coding agents
-* Remembering what you did yesterday
-
----
-
-## ⚠️ Limitations
-
-* Only sees **code changes** (not meetings, docs, etc.)
-* Effort estimation is **heuristic, not accurate**
-* Depends on git history quality
-
----
-
-## Installation
-
-```bash
-pip install gitglimpse
-```
-
-Requirements:
-
-* Python 3.11+
-* git
-* (optional) Ollama or API key
-
----
-
-## Contributing
-
-PRs welcome — especially for:
-
-* better effort estimation
-* smarter task grouping
-* improved noise filtering
-
----
-
-## License
-
-MIT
-
----
-
-<div align="center">
-
-Built by Dino
-
-</div>

gitglimpse-0.1.4/src/gitglimpse/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.4"