Add Copilot CLI V1 capture with hooks, sync, watch, and status

.github/workflows/test.yml

@@ -37,12 +37,9 @@ jobs:
             python-version: "3.13"
           - os: ubuntu-latest
             python-version: "3.14"
-          # Windows support is experimental: minimum supported version plus a
-          # recent stable, to bound runner cost.
+          # Exercise Windows on the project's primary Python version.
           - os: windows-latest
-            python-version: "3.11"
-          - os: windows-latest
-            python-version: "3.13"
+            python-version: "3.12"
 
     steps:
       - uses: actions/checkout@v5

README.md

@@ -9,14 +9,14 @@
 [![Python](https://img.shields.io/pypi/pyversions/thrdi.svg)](https://pypi.org/project/thrdi/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-Trace every agent session on your machine — Claude Code, Codex, Cursor — into one history you and your agents can manage, search, and evaluate.
+Trace every agent session on your machine — Claude Code, Codex, Cursor, GitHub Copilot CLI — into one history you and your agents can manage, search, and evaluate.
 
 ## Install
 
 > **Windows support is experimental.** The test suite runs on Windows in CI, and
-> Claude Code tracing is the verified integration there. The Codex CLI and Cursor
-> installers are implemented but have not been verified against those tools on
-> Windows. Please report Windows problems at the
+> Claude Code tracing is the verified integration there. The Codex CLI, Cursor,
+> and Copilot CLI installers are implemented but have not been live-certified
+> against those tools on Windows. Please report Windows problems at the
 > [issue tracker](https://github.com/duncankmckinnon/thirdeye/issues). See
 > [docs/windows.md](docs/windows.md) for the deliberate platform differences.
 
@@ -79,10 +79,38 @@ rerun `thirdeye skills add --force` to refresh them. See
 ## Enable tracing
 
 ```bash
-thirdeye add --claude        # also: --cursor, --codex
+thirdeye add --claude        # also: --cursor, --codex, --copilot
 ```
 
-To detach: `thirdeye remove --claude`.
+To detach: `thirdeye remove --claude` (also `--cursor`, `--codex`, `--copilot`).
+
+## Copilot CLI V1
+
+GitHub Copilot CLI capture is a V1 immutable raw archive. V2 (reconstructed
+turns, usage accounting, and OTel export) is out of scope. V1 does not export
+Copilot content.
+
+```bash
+thirdeye add --copilot
+thirdeye copilot status --source-home "$COPILOT_HOME"
+thirdeye copilot sync --source-home "$COPILOT_HOME"
+thirdeye copilot watch --source-home "$COPILOT_HOME" --interval 1
+thirdeye remove --copilot
+```
+
+`--source-home` is optional. Resolution is `--source-home`, then `COPILOT_HOME`,
+then `~/.copilot`. V1 reads only that home's `session-state/**/events.jsonl`,
+`workspace.yaml`, and `session-store.db` (`sessions`, `turns`,
+`assistant_usage_events`). It does not read credentials, token-bearing config,
+or other Copilot files.
+
+`thirdeye add --copilot` writes user-level hooks at
+`$COPILOT_HOME/hooks/thirdeye.json` (default `~/.copilot/hooks/thirdeye.json`).
+The 1.0.83 live probe used repository hooks; V1 does not. `watch` is an explicit
+foreground poller and is not started by add or setup. Captured content has the
+same local sensitivity as other thirdeye sessions and is not exported in V1.
+`sync` and `status` print recoverable source diagnostics (locations and reasons,
+not prompt bodies). Passing unit tests is not live certification of Copilot CLI.
 
 ## Read your history
 

docs/windows.md

@@ -2,9 +2,10 @@
 
 Windows support is **experimental**. The test suite runs on `windows-latest` in
 CI across Python 3.11 and 3.13, and Claude Code tracing is the verified
-integration. The Codex CLI and Cursor installers are implemented but have not
-been exercised against those tools on Windows. Please file Windows issues at the
-[issue tracker](https://github.com/duncankmckinnon/thirdeye/issues).
+integration. The Codex CLI, Cursor, and Copilot CLI installers are implemented
+but have not been live-certified against those tools on Windows. Passing Copilot
+unit tests is not live certification of Copilot CLI. Please file Windows issues
+at the [issue tracker](https://github.com/duncankmckinnon/thirdeye/issues).
 
 Install with `pipx` or `uv` — Homebrew stays macOS/Linux only.
 
@@ -35,12 +36,14 @@ A copied skill does not track a thirdeye upgrade the way a symlink does. After
 `pipx upgrade thrdi` (or `uv tool upgrade thrdi`), rerun `thirdeye skills add --force`
 to refresh the copied skills.
 
-### 3. Unverified Codex and Cursor hooks
+### 3. Unverified Codex, Cursor, and Copilot hooks
 
-The Codex CLI and Cursor installers are correct by construction but have not been
-run against the real tools on Windows. How each tool invokes a hook command
-there — `cmd.exe`, PowerShell, or a direct `CreateProcess` — is unconfirmed, and
-therefore so is whether a path containing spaces needs quoting.
+The Codex CLI, Cursor, and Copilot CLI installers are correct by construction
+but have not been run against the real tools on Windows. How each tool invokes a
+hook command there — `cmd.exe`, PowerShell, or a direct `CreateProcess` — is
+unconfirmed, and therefore so is whether a path containing spaces needs quoting.
+Copilot V1 still writes user-level `$COPILOT_HOME/hooks/thirdeye.json` (default
+`~/.copilot/hooks/thirdeye.json`); the 1.0.83 probe used repository hooks.
 
 To sidestep the question, on Windows only, when the resolved hook binary path
 contains a space thirdeye writes the bare binary name into the tool's config

pyproject.toml

@@ -60,6 +60,7 @@ thirdeye-codex-pre-compact = "thirdeye.platforms.codex.hooks_json:pre_compact"
 thirdeye-codex-post-compact = "thirdeye.platforms.codex.hooks_json:post_compact"
 thirdeye-codex-session-end = "thirdeye.platforms.codex.hooks_json:session_end"
 thirdeye-cursor-hook = "thirdeye.platforms.cursor.hook:main"
+thirdeye-copilot-hook = "thirdeye.platforms.copilot.hooks:main"
 
 [build-system]
 requires = ["setuptools>=64", "setuptools-scm>=8", "wheel"]

src/thirdeye/_compat/fsops.py

@@ -62,6 +62,27 @@ def unlink(path: Path, *, missing_ok: bool = False) -> None:
         path.unlink(missing_ok=missing_ok)
 
 
+def sync_directory(path: Path | str) -> None:
+    """Best-effort ``fsync`` of a directory after ``replace`` or ``unlink``.
+
+    Publishing a file with tmp-plus-replace (or removing a journal) is not
+    durable until the directory entry itself is synced. Some platforms,
+    notably Windows, reject directory ``fsync``; those errors are ignored so
+    callers stay portable.
+    """
+    path = Path(path)
+    try:
+        fd = os.open(path, os.O_RDONLY)
+    except OSError:
+        return
+    try:
+        os.fsync(fd)
+    except OSError:
+        return
+    finally:
+        os.close(fd)
+
+
 def read_text(path: Path | str, *, encoding: str = "utf-8") -> str:
     """``Path.read_text`` with bounded retry on Windows ``PermissionError``.
 

src/thirdeye/cli.py

@@ -7,6 +7,7 @@
 from thirdeye.commands.add import add, remove
 from thirdeye.commands.agent import agent_cmd
 from thirdeye.commands.capture_env import capture_env_group
+from thirdeye.commands.copilot import copilot_group
 from thirdeye.commands.eval import eval_group
 from thirdeye.commands.ingest import ingest
 from thirdeye.commands.logfire_cmd import logfire_group
@@ -28,6 +29,7 @@ def main() -> None:
 main.add_command(add)
 main.add_command(remove)
 main.add_command(ingest)
+main.add_command(copilot_group)
 main.add_command(list_sessions)
 main.add_command(show)
 main.add_command(events)

src/thirdeye/commands/add.py

@@ -9,12 +9,14 @@
 from thirdeye.platforms.base import Platform
 from thirdeye.platforms.claude.install import ClaudePlatform
 from thirdeye.platforms.codex.install import CodexPlatform
+from thirdeye.platforms.copilot.install import CopilotPlatform
 from thirdeye.platforms.cursor.install import CursorPlatform
 
 PLATFORMS: dict[str, type[Platform]] = {
     "claude": ClaudePlatform,
     "codex": CodexPlatform,
     "cursor": CursorPlatform,
+    "copilot": CopilotPlatform,
 }
 
 # Config files that may still reference console scripts for platforms this
@@ -25,6 +27,9 @@
 
 
 def _platform_options(fn):
+    fn = click.option(
+        "--copilot", "platform_flag", flag_value="copilot", help="GitHub Copilot CLI."
+    )(fn)
     fn = click.option("--cursor", "platform_flag", flag_value="cursor", help="Cursor.")(fn)
     fn = click.option("--codex", "platform_flag", flag_value="codex", help="Codex CLI.")(fn)
     fn = click.option("--claude", "platform_flag", flag_value="claude", help="Claude Code.")(fn)
@@ -33,7 +38,7 @@ def _platform_options(fn):
 
 def _resolve_platform(platform_flag: str | None, *, force: bool = False) -> Platform:
     if not platform_flag:
-        raise click.UsageError("Pick a platform: --claude, --codex, --cursor")
+        raise click.UsageError("Pick a platform: " + ", ".join(f"--{name}" for name in PLATFORMS))
     platform_cls = PLATFORMS[platform_flag]
     if platform_flag == "codex" and force:
         return platform_cls(force=True)