clockwork-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{clockwork_cli-0.1.0/src/clockwork_cli.egg-info → clockwork_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clockwork-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: Mine your Claude Code and Codex session logs to estimate active time
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/danielsich/clockwork
@@ -18,6 +18,10 @@ Dynamic: license-file
 
 # clockwork
 
+[![PyPI](https://img.shields.io/pypi/v/clockwork-cli)](https://pypi.org/project/clockwork-cli/)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/danielsich/clockwork)
+
 A tiny, dependency-free CLI that mines your **Claude Code** and **Codex**
 session logs to estimate how much *active* time you've actually spent — per
 project, per day — and renders it as ASCII bar charts in your terminal.
@@ -78,11 +82,19 @@ midnight is credited to each day it spans.
 
 ## Requirements
 
-- Python 3.7+ (standard library only — no `pip install` needed)
+- Python 3.7+ (standard library only — no dependencies)
 
 ## Install
 
-**macOS / Linux**
+**pip (recommended — works on macOS, Linux, and Windows)**
+
+```bash
+pip install clockwork-cli
+```
+
+This puts `clockwork` on your PATH. Done.
+
+**From source — macOS / Linux**
 
 ```bash
 git clone https://github.com/danielsich/clockwork.git
@@ -96,7 +108,7 @@ ln -s "$PWD/clockwork" ~/.local/bin/clockwork
 ./clockwork claude all
 ```
 
-**Windows**
+**From source — Windows**
 
 ```powershell
 git clone https://github.com/danielsich/clockwork.git
@@ -104,14 +116,10 @@ cd clockwork
 
 # Run directly with Python (the shebang line is ignored on Windows)
 python clockwork claude all
-
-# Or add the directory to your PATH and invoke as:
-python -m clockwork claude all   # not needed — just call the script
 ```
 
-> clockwork looks for Claude logs in `%APPDATA%\Claude\projects` first, then
-> `~\.claude\projects`. One of those will already exist if you have Claude Code
-> installed.
+> On Windows, clockwork looks for Claude logs in `%APPDATA%\Claude\projects`
+> first, then `~\.claude\projects`.
 
 ## Usage
 

{clockwork_cli-0.1.0 → clockwork_cli-0.1.2}/README.md

@@ -1,5 +1,9 @@
 # clockwork
 
+[![PyPI](https://img.shields.io/pypi/v/clockwork-cli)](https://pypi.org/project/clockwork-cli/)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/danielsich/clockwork)
+
 A tiny, dependency-free CLI that mines your **Claude Code** and **Codex**
 session logs to estimate how much *active* time you've actually spent — per
 project, per day — and renders it as ASCII bar charts in your terminal.
@@ -60,11 +64,19 @@ midnight is credited to each day it spans.
 
 ## Requirements
 
-- Python 3.7+ (standard library only — no `pip install` needed)
+- Python 3.7+ (standard library only — no dependencies)
 
 ## Install
 
-**macOS / Linux**
+**pip (recommended — works on macOS, Linux, and Windows)**
+
+```bash
+pip install clockwork-cli
+```
+
+This puts `clockwork` on your PATH. Done.
+
+**From source — macOS / Linux**
 
 ```bash
 git clone https://github.com/danielsich/clockwork.git
@@ -78,7 +90,7 @@ ln -s "$PWD/clockwork" ~/.local/bin/clockwork
 ./clockwork claude all
 ```
 
-**Windows**
+**From source — Windows**
 
 ```powershell
 git clone https://github.com/danielsich/clockwork.git
@@ -86,14 +98,10 @@ cd clockwork
 
 # Run directly with Python (the shebang line is ignored on Windows)
 python clockwork claude all
-
-# Or add the directory to your PATH and invoke as:
-python -m clockwork claude all   # not needed — just call the script
 ```
 
-> clockwork looks for Claude logs in `%APPDATA%\Claude\projects` first, then
-> `~\.claude\projects`. One of those will already exist if you have Claude Code
-> installed.
+> On Windows, clockwork looks for Claude logs in `%APPDATA%\Claude\projects`
+> first, then `~\.claude\projects`.
 
 ## Usage
 

{clockwork_cli-0.1.0 → clockwork_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clockwork-cli"
-version = "0.1.0"
+version = "0.1.2"
 description = "Mine your Claude Code and Codex session logs to estimate active time"
 readme = "README.md"
 license = "MIT"

{clockwork_cli-0.1.0 → clockwork_cli-0.1.2}/src/clockwork_cli/__init__.py

@@ -55,7 +55,7 @@ import hashlib
 from datetime import datetime, timedelta, timezone
 from collections import defaultdict
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 
 
 def _resolve_claude_dir():
@@ -200,6 +200,34 @@ def _print_json(obj):
     print(json.dumps(obj, indent=2))
 
 
+def _stdout_target():
+    """Best-effort name of where stdout is going, for status messages.
+
+    Returns the basename of the file when stdout is redirected to a regular
+    file (`> out.json`), or None for a terminal or a pipe. Purely cosmetic;
+    any failure degrades to None so it never affects the export itself.
+    """
+    try:
+        if os.isatty(1):
+            return None
+    except Exception:
+        return None
+    path = None
+    try:  # macOS / BSD: ask the kernel for fd 1's path
+        import fcntl
+        f_getpath = getattr(fcntl, "F_GETPATH", 50)
+        raw = fcntl.fcntl(1, f_getpath, b"\0" * 1024)
+        path = raw.split(b"\0", 1)[0].decode() or None
+    except Exception:
+        try:  # Linux: /proc symlink
+            path = os.readlink("/proc/self/fd/1")
+        except Exception:
+            path = None
+    if path and os.path.isfile(path):
+        return os.path.basename(path)
+    return None
+
+
 def _project_id(path):
     """Stable short id for a project path (survives anonymization)."""
     return hashlib.sha1(path.encode("utf-8")).hexdigest()[:8]
@@ -838,6 +866,18 @@ def export_data(provider, idle_threshold, since, until, detail, anonymize):
         },
     })
 
+    # A friendly receipt on stderr — keeps stdout pure JSON for redirection.
+    dest = _stdout_target()
+    where = dest if dest else "stdout"
+    tags = [provider, f"detail={detail}"]
+    if anonymize:
+        tags.append("anonymized")
+    print(f"\n  ✓ export complete → {where}", file=sys.stderr)
+    print(f"    {' · '.join(tags)}", file=sys.stderr)
+    print(f"    {len(out_projects)} projects · {grand_prompts:,} prompts "
+          f"· {grand_sessions:,} sessions · {grand_minutes / 60:.1f}h active",
+          file=sys.stderr)
+
 
 def list_projects(provider, as_json):
     projects = PROVIDERS[provider]["list"]()
@@ -894,7 +934,11 @@ def _parse_args(argv):
 
 
 def main():
-    positionals, opts = _parse_args(sys.argv[1:])
+    argv = sys.argv[1:]
+    if "-h" in argv or "--help" in argv:
+        print(__doc__.strip())
+        sys.exit(0)
+    positionals, opts = _parse_args(argv)
     if len(positionals) < 2:
         print(__doc__.strip())
         sys.exit(1)

{clockwork_cli-0.1.0 → clockwork_cli-0.1.2/src/clockwork_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clockwork-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: Mine your Claude Code and Codex session logs to estimate active time
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/danielsich/clockwork
@@ -18,6 +18,10 @@ Dynamic: license-file
 
 # clockwork
 
+[![PyPI](https://img.shields.io/pypi/v/clockwork-cli)](https://pypi.org/project/clockwork-cli/)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/danielsich/clockwork)
+
 A tiny, dependency-free CLI that mines your **Claude Code** and **Codex**
 session logs to estimate how much *active* time you've actually spent — per
 project, per day — and renders it as ASCII bar charts in your terminal.
@@ -78,11 +82,19 @@ midnight is credited to each day it spans.
 
 ## Requirements
 
-- Python 3.7+ (standard library only — no `pip install` needed)
+- Python 3.7+ (standard library only — no dependencies)
 
 ## Install
 
-**macOS / Linux**
+**pip (recommended — works on macOS, Linux, and Windows)**
+
+```bash
+pip install clockwork-cli
+```
+
+This puts `clockwork` on your PATH. Done.
+
+**From source — macOS / Linux**
 
 ```bash
 git clone https://github.com/danielsich/clockwork.git
@@ -96,7 +108,7 @@ ln -s "$PWD/clockwork" ~/.local/bin/clockwork
 ./clockwork claude all
 ```
 
-**Windows**
+**From source — Windows**
 
 ```powershell
 git clone https://github.com/danielsich/clockwork.git
@@ -104,14 +116,10 @@ cd clockwork
 
 # Run directly with Python (the shebang line is ignored on Windows)
 python clockwork claude all
-
-# Or add the directory to your PATH and invoke as:
-python -m clockwork claude all   # not needed — just call the script
 ```
 
-> clockwork looks for Claude logs in `%APPDATA%\Claude\projects` first, then
-> `~\.claude\projects`. One of those will already exist if you have Claude Code
-> installed.
+> On Windows, clockwork looks for Claude logs in `%APPDATA%\Claude\projects`
+> first, then `~\.claude\projects`.
 
 ## Usage