From 07a9d19ea9d4b3f4b18c6e9783e1c50ba5ac33cf Mon Sep 17 00:00:00 2001
From: openhands <openhands@all-hands.dev>
Date: Tue, 9 Jun 2026 04:23:32 +0000
Subject: [PATCH] feat: add --json output mode for machine-readable context

Usage: git context --json --log 5 | jq .
---
 git_context/__init__.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/git_context/__init__.py b/git_context/__init__.py
index 92e2b81..41992da 100755
--- a/git_context/__init__.py
+++ b/git_context/__init__.py
@@ -14,6 +14,8 @@
 import fnmatch
 from pathlib import Path
 from datetime import datetime
+import json
+import json
 
 DEFAULT_IGNORE = {
     '.git', 'node_modules', '.next', 'dist', 'build', 'target',
@@ -127,6 +129,7 @@ def main():
     p.add_argument('--files', action='store_true', help='Include source file contents')
     p.add_argument('--log', type=int, default=20, help='Number of recent commits (default: 20, 0=skip)')
     p.add_argument('--output', '-o', help='Write to file instead of stdout')
+    p.add_argument('--json', action='store_true', help='Output as JSON')
     p.add_argument('--dir', default=os.getcwd(), help='Target directory (default: cwd)')
     args = p.parse_args()
 
@@ -135,6 +138,26 @@ def main():
         print(f"❌ Not a git repo: {target}", file=sys.stderr)
         sys.exit(1)
 
+    if args.json:
+        branch = run(["git", "rev-parse", "--abbrev-ref", "HEAD"], target)
+        remote = run(["git", "remote", "get-url", "origin"], target)
+        clean = not run(["git", "diff", "--stat"], target) and not run(["git", "diff", "--cached", "--stat"], target)
+        log_entries = []
+        if args.log > 0:
+            raw = run(["git", "log", f"--max-count={args.log}", "--pretty=format:%h|||%s|||%an|||%ar"], target)
+            for line in raw.split(chr(10)) if raw else []:
+                parts = line.split("|||", 3)
+                if len(parts) == 4:
+                    log_entries.append({"hash": parts[0], "subject": parts[1], "author": parts[2], "date": parts[3]})
+        data = {"repo": os.path.basename(target), "branch": branch, "remote": remote, "clean": clean, "commits": log_entries}
+        output = json.dumps(data, indent=2)
+        if args.output:
+            Path(args.output).write_text(output)
+            print(f"Written to {args.output}")
+        else:
+            print(output)
+        return
+
     repo_name = os.path.basename(target)
     sections = []
     sections.append(f"# git-context: {repo_name}")