---
name: ShadowLock
description: Use when comparing an observed outcome to a counterfactual without storing PII. OS-hooks into AZ-OS for process/job observation under ethics policy. Hosted /v1 via this Worker or aziel-runtime. Author Aziel Eliab.
---

# ShadowLock

Change is optional. Truth is not.

Author: **Aziel Eliab**.

Use when comparing an observed outcome to a counterfactual without storing PII. OS-hooks into AZ-OS for process/job observation under ethics policy.

Always send `User-Agent: Mozilla/5.0`. Cloudflare Workers may 403 an empty agent.

## Endpoints (this Worker)

Host: `https://shadowlock-download-tracker.vibelock.workers.dev`

| Method | Path | What |
|--------|------|------|
| GET | `/v1/health` | Liveness. Does not increment downloads. |
| GET | `/v1/skill` | This markdown. Does not increment downloads. |
| POST | `/v1/observe` | Observe {observed, counterfactual} or {jobs}. Not stored. |
| POST | `/v1/hook` | Ethics-gated AZ-OS hook frame. Not stored. |

OpenAPI: `https://shadowlock-download-tracker.vibelock.workers.dev/openapi.json`

Catalog OpenAPI: `https://godlock.uk/runtime/openapi.json`

MCP: `POST https://godlock.uk/runtime/mcp`

Catalog aliases under `/p/shadowlock/…`.

## How to call (Mozilla/5.0)

```bash
curl -s -A 'Mozilla/5.0' https://shadowlock-download-tracker.vibelock.workers.dev/v1/health
curl -s -A 'Mozilla/5.0' -X POST https://shadowlock-download-tracker.vibelock.workers.dev/v1/observe \
  -H 'content-type: application/json' \
  -d '{"observed":{"id":"job-1","outcome":"done"},"counterfactual":{"outcome":"skipped"}}'
curl -s -A 'Mozilla/5.0' -X POST https://shadowlock-download-tracker.vibelock.workers.dev/v1/hook \
  -H 'content-type: application/json' \
  -d '{"jobs":[{"id":"job-1","task_class":"repair","actual_outcome":"complete"}]}'
curl -s -A 'Mozilla/5.0' https://shadowlock-download-tracker.vibelock.workers.dev/v1/skill
```

Works with ChatGPT (GPT Actions / OpenAI), Grok (xAI), Venice, Claude (Anthropic), Cursor (MCP), Glama (MCP), Perplexity, Microsoft Copilot / Bing, Google Gemini / Vertex, Mistral, Meta AI, Apple Intelligence surfaces, Amazon Q tooling, DuckAssist, You.com, Cohere, and other MCP/OpenAPI-capable assistants. OpenAPI: import as a GPT Action, custom tool, or HTTP tool. MCP: POST the catalog /mcp endpoint for Cursor, Glama, Claude, and other MCP clients.

## Local (after one-click install)

```bash
curl -fsSL https://shadowlock-download-tracker.vibelock.workers.dev/install.sh | bash
shadowlock ui
shadowlock attach
```

Then open http://127.0.0.1:8764 (this computer only). AZ-OS: `azos ui` at http://127.0.0.1:8800.

## Honest banner

THIS IS: a counterfactual observation envelope with hashed ids. OS-hooks into AZ-OS under ethics policy. THIS IS NOT: a people profiler, PII store, truth score, kernel hook, or process controller. Zero-retention on /v1. Author Aziel Eliab.

Hosted product UI: `GET https://shadowlock-download-tracker.vibelock.workers.dev/` — observe workspace + counted download.

Citation: Eliab, Aziel. (2026). ShadowLock 0.2.0 [Software]. Apache-2.0. https://github.com/AzielEliab/shadowlock

Historical DOI 10.5281/zenodo.21435707 is tombstoned (Zenodo 410/404). Software deposit needed. No DOI invented.

Apache-2.0 (or the repo LICENSE). Forks are welcome and always allowed.

## Catalog + local UI

Author: **Aziel Eliab**. Honest scope: OS-hooks into AZ-OS for process/job observation under ethics policy.

- Catalog product: https://godlock.uk/runtime/p/shadowlock/
- Catalog OpenAPI: https://godlock.uk/runtime/openapi.json
- Catalog MCP: `POST https://godlock.uk/runtime/mcp`
- This Worker skill: `GET https://shadowlock-download-tracker.vibelock.workers.dev/v1/skill`
- This Worker OpenAPI: https://shadowlock-download-tracker.vibelock.workers.dev/openapi.json

Local UI: **Import JSON file** or **Attach via AZ-OS**, then **Export JSON**. Then `shadowlock doctor`.