inscript 0.1.0__tar.gz

inscript-0.1.0/LICENSE

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

inscript-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: inscript
+Version: 0.1.0
+Summary: Universal agent context tracking. Know what codebase the agent is working in.
+Author: Andrew Park
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aardpark/trace
+Keywords: ai,agent,context,mcp,claude
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# trace
+
+Universal agent context tracking.
+
+When an AI agent works on code, **trace** records which project it's in. Any tool — MCP servers, hooks, scripts — can read `~/.trace/active_project` to know the current context.
+
+## Install
+
+```bash
+pip install trace
+```
+
+## How it works
+
+A Claude Code hook fires on every file operation (Read, Edit, Write). It extracts the git root from the file path and writes it to `~/.trace/active_project`. That's it.
+
+Any tool can read this file. No coordination needed.
+
+## Python API
+
+```python
+from trace_pkg import active_project
+
+project = active_project()  # Path("/Users/you/your-project") or None
+```
+
+## CLI
+
+```bash
+trace          # print active project
+trace set .    # manually set active project
+```
+
+## Claude Code setup
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Read|Edit|Write|Glob|Grep",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "trace-hook",
+            "async": true
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Why
+
+MCP servers need to know what project the agent is working in. Without trace, each server has to guess from cwd, env vars, or explicit configuration. With trace, there's one source of truth that updates automatically.

inscript-0.1.0/README.md

@@ -0,0 +1,59 @@
+# trace
+
+Universal agent context tracking.
+
+When an AI agent works on code, **trace** records which project it's in. Any tool — MCP servers, hooks, scripts — can read `~/.trace/active_project` to know the current context.
+
+## Install
+
+```bash
+pip install trace
+```
+
+## How it works
+
+A Claude Code hook fires on every file operation (Read, Edit, Write). It extracts the git root from the file path and writes it to `~/.trace/active_project`. That's it.
+
+Any tool can read this file. No coordination needed.
+
+## Python API
+
+```python
+from trace_pkg import active_project
+
+project = active_project()  # Path("/Users/you/your-project") or None
+```
+
+## CLI
+
+```bash
+trace          # print active project
+trace set .    # manually set active project
+```
+
+## Claude Code setup
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Read|Edit|Write|Glob|Grep",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "trace-hook",
+            "async": true
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Why
+
+MCP servers need to know what project the agent is working in. Without trace, each server has to guess from cwd, env vars, or explicit configuration. With trace, there's one source of truth that updates automatically.

inscript-0.1.0/inscript.egg-info/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: inscript
+Version: 0.1.0
+Summary: Universal agent context tracking. Know what codebase the agent is working in.
+Author: Andrew Park
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aardpark/trace
+Keywords: ai,agent,context,mcp,claude
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# trace
+
+Universal agent context tracking.
+
+When an AI agent works on code, **trace** records which project it's in. Any tool — MCP servers, hooks, scripts — can read `~/.trace/active_project` to know the current context.
+
+## Install
+
+```bash
+pip install trace
+```
+
+## How it works
+
+A Claude Code hook fires on every file operation (Read, Edit, Write). It extracts the git root from the file path and writes it to `~/.trace/active_project`. That's it.
+
+Any tool can read this file. No coordination needed.
+
+## Python API
+
+```python
+from trace_pkg import active_project
+
+project = active_project()  # Path("/Users/you/your-project") or None
+```
+
+## CLI
+
+```bash
+trace          # print active project
+trace set .    # manually set active project
+```
+
+## Claude Code setup
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Read|Edit|Write|Glob|Grep",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "trace-hook",
+            "async": true
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+## Why
+
+MCP servers need to know what project the agent is working in. Without trace, each server has to guess from cwd, env vars, or explicit configuration. With trace, there's one source of truth that updates automatically.

inscript-0.1.0/inscript.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+inscript.egg-info/PKG-INFO
+inscript.egg-info/SOURCES.txt
+inscript.egg-info/dependency_links.txt
+inscript.egg-info/entry_points.txt
+inscript.egg-info/top_level.txt
+trace_pkg/__init__.py
+trace_pkg/hook.py

inscript-0.1.0/inscript.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

inscript-0.1.0/inscript.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+trace = trace_pkg:cli
+trace-hook = trace_pkg.hook:main

inscript-0.1.0/inscript.egg-info/top_level.txt

@@ -0,0 +1 @@
+trace_pkg

inscript-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "inscript"
+version = "0.1.0"
+description = "Universal agent context tracking. Know what codebase the agent is working in."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    {name = "Andrew Park"},
+]
+keywords = ["ai", "agent", "context", "mcp", "claude"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+]
+
+[project.urls]
+Homepage = "https://github.com/aardpark/trace"
+
+[project.scripts]
+trace = "trace_pkg:cli"
+trace-hook = "trace_pkg.hook:main"
+
+[tool.setuptools.packages.find]
+include = ["trace_pkg*"]

inscript-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

inscript-0.1.0/trace_pkg/__init__.py

@@ -0,0 +1,60 @@
+"""Trace — universal agent context tracking.
+
+Tracks what codebase an AI agent is working in. Any tool can read
+~/.trace/active_project to know the current project context.
+
+Usage:
+    from trace_pkg import active_project, set_active_project
+
+    # Read current project
+    project = active_project()  # Path or None
+
+    # Set current project (usually done by the hook)
+    set_active_project("/path/to/project")
+"""
+from __future__ import annotations
+
+from pathlib import Path
+
+__version__ = "0.1.0"
+
+TRACE_DIR = Path.home() / ".trace"
+ACTIVE_PROJECT_FILE = TRACE_DIR / "active_project"
+
+
+def active_project() -> Path | None:
+    """Read the currently active project path."""
+    try:
+        text = ACTIVE_PROJECT_FILE.read_text().strip()
+        if text:
+            p = Path(text)
+            if p.is_dir():
+                return p
+    except (OSError, ValueError):
+        pass
+    return None
+
+
+def set_active_project(path: str | Path) -> None:
+    """Set the active project path."""
+    TRACE_DIR.mkdir(parents=True, exist_ok=True)
+    ACTIVE_PROJECT_FILE.write_text(str(Path(path).resolve()) + "\n")
+
+
+def cli() -> None:
+    """CLI entry point."""
+    import sys
+
+    if len(sys.argv) > 1 and sys.argv[1] == "set":
+        if len(sys.argv) < 3:
+            print("Usage: trace set <path>", file=sys.stderr)
+            sys.exit(1)
+        set_active_project(sys.argv[2])
+        print(f"Active project: {Path(sys.argv[2]).resolve()}")
+    else:
+        project = active_project()
+        if project:
+            print(project)
+        else:
+            print("No active project", file=sys.stderr)
+            sys.exit(1)

inscript-0.1.0/trace_pkg/hook.py

@@ -0,0 +1,78 @@
+"""Claude Code PostToolUse hook — tracks the active project.
+
+Reads tool input JSON from stdin, extracts file paths, finds the git root,
+and writes to ~/.trace/active_project.
+
+Install as a hook or run directly:
+    echo '{"tool_input":{"file_path":"/some/repo/file.py"}}' | trace-hook
+"""
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+
+from . import TRACE_DIR, ACTIVE_PROJECT_FILE
+
+
+def _extract_path(data: dict) -> str | None:
+    """Extract a file path from hook input JSON."""
+    inp = data.get("tool_input", {})
+
+    # Direct file_path field (Read, Edit, Write)
+    path = inp.get("file_path") or inp.get("path")
+    if path and path.startswith("/"):
+        return path
+
+    # Bash command — extract first absolute path
+    command = inp.get("command", "")
+    if command:
+        matches = re.findall(r"(/[^\s;|&\"']+)", command)
+        if matches:
+            return matches[0]
+
+    return None
+
+
+def _find_git_root(path: str) -> Path | None:
+    """Walk up from path to find the git root."""
+    p = Path(path)
+    if p.is_file():
+        p = p.parent
+    while p != p.parent:
+        if (p / ".git").exists():
+            return p
+        p = p.parent
+    return None
+
+
+def main() -> None:
+    """Entry point for the hook."""
+    try:
+        data = json.load(sys.stdin)
+    except (json.JSONDecodeError, EOFError):
+        return
+
+    path = _extract_path(data)
+    if not path:
+        return
+
+    root = _find_git_root(path)
+    if not root:
+        return
+
+    # Only write if changed
+    try:
+        current = ACTIVE_PROJECT_FILE.read_text().strip()
+        if current == str(root):
+            return
+    except OSError:
+        pass
+
+    TRACE_DIR.mkdir(parents=True, exist_ok=True)
+    ACTIVE_PROJECT_FILE.write_text(str(root) + "\n")
+
+
+if __name__ == "__main__":
+    main()