diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..e156790
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,4 @@
+# Language stats: count the Swift app, not its release tooling, benchmarks or experiments.
+scripts/** linguist-detectable=false
+Benchmarks/** linguist-detectable=false
+Experiments/** linguist-detectable=false
diff --git a/README.md b/README.md
index 85de6b0..27eb23a 100644
--- a/README.md
+++ b/README.md
@@ -12,14 +12,14 @@ Capture the window you’re building, mark what should change, and hand the resu
-[**Download for macOS**](https://github.com/Brendan-Lim/ContextLens/releases/tag/v0.3.0-preview.1) · [**Install with Homebrew**](#install) · [**Get started**](#get-started)
+[**Download for macOS**](https://github.com/bstack-tools/ContextLens/releases/tag/v0.3.0-preview.1) · [**Install with Homebrew**](#install) · [**Get started**](#get-started)
-
-
+
+
Free and open source · Apple Silicon · macOS 14 Sonoma or later
@@ -76,7 +76,7 @@ You spot it straight away: the button that’s a few pixels off, the avatar that
-## Why developers use ContextLens
+## Why use ContextLens
@@ -153,18 +153,9 @@ ContextLens prepares the context. Your agent makes the change in your codebase,
### Download
-**[Download ContextLens for macOS](https://github.com/Brendan-Lim/ContextLens/releases/tag/v0.3.0-preview.1)**. Unzip it, move **ContextLens** into your Applications folder, and open it from there.
+**[Download ContextLens for macOS](https://github.com/bstack-tools/ContextLens/releases/tag/v0.3.0-preview.1)**. Unzip it, move **ContextLens** into your Applications folder, and open it from there.
-ContextLens is in public preview. The first stable release, v0.3.1, will add a drag-to-install disk image.
-
-
+ContextLens is in public preview.
### Homebrew
@@ -180,7 +171,7 @@ ContextLens is free and open source, and it isn’t notarized by Apple yet, so m
2. Open **System Settings → Privacy & Security**, scroll down, click **Open Anyway**, and confirm.
3. When prompted, allow **Screen Recording** for ContextLens, then reopen the app.
-Only do this for a copy downloaded from this repository’s [Releases](https://github.com/Brendan-Lim/ContextLens/releases) page; each release lists its SHA-256 checksum. Apple explains the steps in [Safely open apps on your Mac](https://support.apple.com/en-us/102445). You can optionally allow **Accessibility**, which lets ContextLens name the controls you click in a capture. It never reads what you type. More help: [Permissions](docs/permissions.md) · [Troubleshooting](docs/troubleshooting.md)
+Only do this for a copy from this repository’s [Releases](https://github.com/bstack-tools/ContextLens/releases) page, which lists each release’s SHA-256 checksum. Optionally allow **Accessibility** so ContextLens can name the controls you click; it never reads what you type. If capture is still denied, see the [Screen Recording recovery guide](docs/troubleshooting.md#screen-recording-enabled-but-capture-still-fails). More help: [Permissions](docs/permissions.md) · [Troubleshooting](docs/troubleshooting.md)
@@ -197,16 +188,13 @@ Screenshots show whatever was on screen, so look over a hand-off before sharing
## Get started
-On first launch, choose **Check Access**, follow macOS's Screen Recording permission prompts, and relaunch if macOS asks.
-
-> **Screen Recording enabled but capture still denied:** follow the [step-by-step Screen Recording recovery guide](docs/troubleshooting.md#screen-recording-enabled-but-capture-still-fails).
-
-1. Open the app you’re working on, such as a local dev server in your browser.
-2. In ContextLens, press ⌘N, choose that window under **Which window?**, and click **Start Capture**.
-3. Use your app as usual: open the menu, reproduce the bug, walk through the flow. Click **Stop Capture** when you’re done.
-4. In **Review**, untick the states you don’t need and click the one that shows the problem.
-5. In **Mark Up**, drag over the problem and write what should change. Add as many marks as you like.
-6. In **Hand Off**, click **Save Hand Off**, then **Copy prompt**, and paste it into your coding agent.
+1. On first launch, choose **Check Access** and follow macOS's Screen Recording prompts.
+2. Open the app you’re working on, such as a local dev server in your browser.
+3. In ContextLens, press ⌘N, choose that window under **Which window?**, and click **Start Capture**.
+4. Use your app as usual: open the menu, reproduce the bug, walk through the flow. Click **Stop Capture** when you’re done.
+5. In **Review**, untick the states you don’t need and click the one that shows the problem.
+6. In **Mark Up**, drag over the problem and write what should change. Add as many marks as you like.
+7. In **Hand Off**, click **Save Hand Off**, then **Copy prompt**, and paste it into your coding agent.
Tip: **High** sensitivity (the default) catches small interface changes. **Low** ignores minor ones and keeps fewer states.
@@ -217,7 +205,7 @@ Tip: **High** sensitivity (the default) catches small interface changes. **Low**
ContextLens is **[MIT licensed](LICENSE)**, including its branding. It’s written in Swift with zero third-party runtime dependencies, and comes with a command-line tool that uses the same export logic as the app.
```sh
-git clone https://github.com/Brendan-Lim/ContextLens.git
+git clone https://github.com/bstack-tools/ContextLens.git
cd ContextLens
scripts/build-app.sh # builds dist/ContextLens.app and dist/contextlens-cli
scripts/verify.sh # runs the test suite
@@ -225,7 +213,7 @@ scripts/verify.sh # runs the test suite
[Building](docs/building.md) · [Testing](docs/native-testing.md) · [Research](docs/research.md) · [Architecture](docs/architecture.md) · [Export format](docs/export-format.md) · [Using with Claude Code](Integrations/claude-code.md) · [Releases and testing](docs/official-release-preparation.md)
-Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) first, and [open an issue](https://github.com/Brendan-Lim/ContextLens/issues) for bugs you can reproduce.
+Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) first, and [open an issue](https://github.com/bstack-tools/ContextLens/issues) for bugs you can reproduce.
@@ -233,4 +221,6 @@ Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) first, and [o
Stop explaining your UI. Just show it.
+
+Built by Brendan Lim · part of bstack
diff --git a/distribution/homebrew/README.md b/distribution/homebrew/README.md
index 63ae22f..b13dca9 100644
--- a/distribution/homebrew/README.md
+++ b/distribution/homebrew/README.md
@@ -2,7 +2,7 @@
## Unnotarized preview channel
-The separate `contextlens-preview` channel installs [ContextLens 0.3.0-preview.1](https://github.com/Brendan-Lim/ContextLens/releases/tag/v0.3.0-preview.1). The cask uses the verified published archive and actual SHA-256. [Candidate verification 42471268060](https://github.com/Brendan-Lim/homebrew-tap/actions/runs/42471268060) passed on a disposable arm64 macOS 15.8.2 runner with Homebrew 7.0.12: style, online audit, fetch/checksum, installation, app placement, CLI linking/help, quarantine retention, existing-app protection and uninstall preservation of session/export markers.
+The separate `contextlens-preview` channel installs [ContextLens 0.3.0-preview.1](https://github.com/bstack-tools/ContextLens/releases/tag/v0.3.0-preview.1). The cask uses the verified published archive and actual SHA-256. [Candidate verification 42471268060](https://github.com/Brendan-Lim/homebrew-tap/actions/runs/42471268060) passed on a disposable arm64 macOS 15.8.2 runner with Homebrew 7.0.12: style, online audit, fetch/checksum, installation, app placement, CLI linking/help, quarantine retention, existing-app protection and uninstall preservation of session/export markers.
```sh
brew install --cask Brendan-Lim/tap/contextlens-preview
@@ -16,7 +16,7 @@ Previews are optimized arm64 builds for macOS 14+, ad-hoc signed without Develop
The cask installs `ContextLens.app` and links its embedded `contextlens-cli`. It conflicts with the future stable cask and default Homebrew installation refuses to overwrite an existing app. Quit and deliberately back up an existing copy before switching channels; do not use force/adopt options. Both channels share the bundle ID, sessions and CLI name, so do not treat another app directory as isolation.
-Preview uninstall preserves sessions, settings and exported packages: there is no `zap` or deletion hook. Hosted checks use only a disposable GitHub macOS runner; manual Gatekeeper authorization, fresh-user Screen Recording and interactive capture/Hand Off remain pending. [Full preview instructions and report](https://github.com/Brendan-Lim/ContextLens/blob/main/docs/preview-releases.md).
+Preview uninstall preserves sessions, settings and exported packages: there is no `zap` or deletion hook. Hosted checks use only a disposable GitHub macOS runner; manual Gatekeeper authorization, fresh-user Screen Recording and interactive capture/Hand Off remain pending. [Full preview instructions and report](https://github.com/bstack-tools/ContextLens/blob/main/docs/preview-releases.md).
Maintainers: `python3 scripts/validate.py` checks both channel templates and generated casks. Generate a preview cask with the main repository's `python3 scripts/preview-release.py update-tap VERSION /path/to/tap`. Push candidates under `preview/**` to run style, online audit, fetch and disposable install/uninstall checks before promoting to main. `scripts/test-preview-install.py` refuses to run outside a GitHub-hosted runner and does not authorize or launch the GUI app.
@@ -24,7 +24,7 @@ Maintainers: `python3 scripts/validate.py` checks both channel templates and gen
Stable ContextLens distribution is pending Developer ID signing and Apple notarization. This channel contains a cask template and validation tooling. **There is no installable stable `contextlens` cask yet.**
-Source: [Brendan-Lim/ContextLens](https://github.com/Brendan-Lim/ContextLens). The native app captures and annotates a selected macOS window and exports local visual context for coding agents.
+Source: [bstack-tools/ContextLens](https://github.com/bstack-tools/ContextLens). The native app captures and annotates a selected macOS window and exports local visual context for coding agents.
Validate the pending template with `python3 scripts/validate.py`. It uses Ruby's parser without inventing a checksum or download. The workflow audits a real cask only after a verified release exists.
diff --git a/docs/beta-acceptance.md b/docs/beta-acceptance.md
index 0243299..e437e9f 100644
--- a/docs/beta-acceptance.md
+++ b/docs/beta-acceptance.md
@@ -8,7 +8,7 @@ Record the test date, macOS version, architecture, Homebrew version, preview tag
## Installation and trust
-1. Confirm the disposable machine has no ContextLens app/cask or `contextlens-cli` link and no sessions that matter. Review the official [preview release](https://github.com/Brendan-Lim/ContextLens/releases/tag/v0.3.0-preview.1) and [preview limitations](preview-releases.md). The ZIP SHA-256 must be `1cd84d6b15fc7aed7346ff1fd27382d5d2cd5a51637c7358861ddf55ebe0da45`.
+1. Confirm the disposable machine has no ContextLens app/cask or `contextlens-cli` link and no sessions that matter. Review the official [preview release](https://github.com/bstack-tools/ContextLens/releases/tag/v0.3.0-preview.1) and [preview limitations](preview-releases.md). The ZIP SHA-256 must be `1cd84d6b15fc7aed7346ff1fd27382d5d2cd5a51637c7358861ddf55ebe0da45`.
2. Run `brew install --cask Brendan-Lim/tap/contextlens-preview`. Check `/Applications/ContextLens.app`, `command -v contextlens-cli`, and `xattr -p com.apple.quarantine /Applications/ContextLens.app`. This last command reads quarantine; it must not remove it. Verify the embedded `Contents/Resources/preview.json` records source `4b463d3e6dfc3ec4035f89d0e9f8787dee08ff4c` and unnotarized ad-hoc trust.
3. Open the app from Finder. Record the actual warning and available choices. No warning is not proof of Apple trust; note the machine's policy and prior authorization. A read-only assessment is `spctl --assess --type execute -vv /Applications/ContextLens.app`; the hosted runner returned rejection.
4. Only after the tester chooses to trust the verified origin, follow [Apple's Open Anyway procedure](https://support.apple.com/en-us/102445): try opening, dismiss the alert, open System Settings → Privacy & Security → Open Anyway, then confirm Open. Record the real result. Do not disable Gatekeeper, strip quarantine, use force/adopt flags, change managed policy or automate the approval.
diff --git a/docs/building.md b/docs/building.md
index 6f71c5c..5c9fa7e 100644
--- a/docs/building.md
+++ b/docs/building.md
@@ -5,7 +5,7 @@ For free binary downloads without Apple credentials, see the separate [unnotariz
Use an Apple Silicon Mac running macOS 14 or newer and Xcode with Swift 5.10 or newer. There are no production dependencies. Local verification used macOS 26.6.2, Xcode 26.6 and Swift 6.3.3. Hosted CI selects Xcode 26.3 on `macos-15` and records the actual versions. macOS 14 is the deployment target; execution on macOS 14 has not been verified.
```sh
-git clone https://github.com/Brendan-Lim/ContextLens.git
+git clone https://github.com/bstack-tools/ContextLens.git
cd ContextLens
scripts/build-app.sh
open dist/ContextLens.app
diff --git a/docs/official-release-preparation.md b/docs/official-release-preparation.md
index acecb97..a38fbd1 100644
--- a/docs/official-release-preparation.md
+++ b/docs/official-release-preparation.md
@@ -1,10 +1,10 @@
# Official unnotarized release preparation
-The published download is [v0.3.0-preview.1](https://github.com/Brendan-Lim/ContextLens/releases/tag/v0.3.0-preview.1). v0.3.1/build 6 is an **unpublished candidate**, with ad-hoc signatures, no Developer ID and no Apple notarization. No installable stable Homebrew cask exists. The separate [Developer ID workflow](releasing.md) keeps its signing, notarization and Gatekeeper requirements.
+The published download is [v0.3.0-preview.1](https://github.com/bstack-tools/ContextLens/releases/tag/v0.3.0-preview.1). v0.3.1/build 6 is an **unpublished candidate**, with ad-hoc signatures, no Developer ID and no Apple notarization. No installable stable Homebrew cask exists. The separate [Developer ID workflow](releasing.md) keeps its signing, notarization and Gatekeeper requirements.
## Candidate baseline
-[Prepare-only run 42601149595](https://github.com/Brendan-Lim/ContextLens/actions/runs/42601149595) prepared the integrated Retina source below; its promotion job was skipped. Independent package verification and exact-byte native engineering checks passed all 14 engineering cases, including real Finder Light/Dark, drag/install/eject/launch, Low/High capture, Review/Mark Up, Hand Off and lifecycle/recovery. The seven owner-approved genuine Retina screenshots are integrated in the README; [the kit](screenshot-kit/README.md) describes their provenance.
+[Prepare-only run 42601149595](https://github.com/bstack-tools/ContextLens/actions/runs/42601149595) prepared the integrated Retina source below; its promotion job was skipped. Independent package verification and exact-byte native engineering checks passed all 14 engineering cases, including real Finder Light/Dark, drag/install/eject/launch, Low/High capture, Review/Mark Up, Hand Off and lifecycle/recovery. The seven owner-approved genuine Retina screenshots are integrated in the README; [the kit](screenshot-kit/README.md) describes their provenance.
| Identity | Value |
|---|---|
@@ -27,7 +27,7 @@ Five human security cases remain pending: genuine quarantined first launch, user
3. Download that exact artifact into a fresh directory and verify it on an independent Mac:
```sh
- gh run download RUN_ID --repo Brendan-Lim/ContextLens --name official-candidate-0.3.1 --dir CANDIDATE
+ gh run download RUN_ID --repo bstack-tools/ContextLens --name official-candidate-0.3.1 --dir CANDIDATE
(cd CANDIDATE && shasum -a 256 -c SHA256SUMS)
.build/dmg-python/bin/python scripts/unnotarized-release.py verify-assets CANDIDATE
```
diff --git a/docs/preview-releases.md b/docs/preview-releases.md
index d212f6b..81cb908 100644
--- a/docs/preview-releases.md
+++ b/docs/preview-releases.md
@@ -2,7 +2,7 @@
ContextLens 0.3.0 has a separate preview channel for Apple Silicon Macs running macOS 14+. It needs no paid Apple Developer membership or Apple credentials. Builds use optimized arm64 Swift products and ad-hoc signatures for code integrity. They have **no Developer ID signature, Apple notarization or promised Gatekeeper acceptance**. These prereleases are never marked latest/stable. macOS 14 is the deployment target; hosted runtime checks use macOS 15.
-Published: [v0.3.0-preview.1 — Unnotarized Preview](https://github.com/Brendan-Lim/ContextLens/releases/tag/v0.3.0-preview.1), after [all preview workflow checks passed](https://github.com/Brendan-Lim/ContextLens/actions/runs/42469995205). The public ZIP was downloaded independently and verified. The separate cask is published in the [tap](https://github.com/Brendan-Lim/homebrew-tap) after [all candidate checks passed](https://github.com/Brendan-Lim/homebrew-tap/actions/runs/42471268060), including online audit, download, installation and uninstallation. The interactive installed-preview workflow remains pending. The stable `contextlens` template and signed `release.yml` remain separate. [Official candidate and release gates](official-release-preparation.md).
+Published: [v0.3.0-preview.1 — Unnotarized Preview](https://github.com/bstack-tools/ContextLens/releases/tag/v0.3.0-preview.1), after [all preview workflow checks passed](https://github.com/bstack-tools/ContextLens/actions/runs/42469995205). The public ZIP was downloaded independently and verified. The separate cask is published in the [tap](https://github.com/Brendan-Lim/homebrew-tap) after [all candidate checks passed](https://github.com/Brendan-Lim/homebrew-tap/actions/runs/42471268060), including online audit, download, installation and uninstallation. The interactive installed-preview workflow remains pending. The stable `contextlens` template and signed `release.yml` remain separate. [Official candidate and release gates](official-release-preparation.md).
```sh
brew install --cask Brendan-Lim/tap/contextlens-preview
@@ -25,7 +25,7 @@ Compare the output with the full checksum above before extracting and authorizin
## For a first-time user
-1. Review the source and the release at the official [ContextLens repository](https://github.com/Brendan-Lim/ContextLens). Use only an explicitly labeled **Unnotarized Preview**. Confirm its version, source commit and published checksum. Ad-hoc signing does not authenticate the developer; neither a checksum nor passing tests makes it Apple-verified.
+1. Review the source and the release at the official [ContextLens repository](https://github.com/bstack-tools/ContextLens). Use only an explicitly labeled **Unnotarized Preview**. Confirm its version, source commit and published checksum. Ad-hoc signing does not authenticate the developer; neither a checksum nor passing tests makes it Apple-verified.
2. Download the versioned ZIP and its `.zip.sha256` from that release. In the download directory run `shasum -a 256 -c ContextLens-0.3.0-preview.1-arm64.zip.sha256`. The checksum should report `OK`. Stop if it differs. A checksum obtained from the same release protects against mismatched downloads, not compromise of the release account.
3. For a direct download, extract the ZIP and drag `ContextLens.app` into Applications. If you already have a copy, quit it and deliberately back it up before switching. Do not overwrite your working app just to try the preview. The channels share a bundle ID, session location and CLI name; they are not isolated side-by-side installations.
4. Try opening ContextLens. If macOS blocks it because the developer cannot be verified or Apple cannot check it, dismiss the alert. Only if you trust the origin and intact download, open **System Settings → Privacy & Security**, scroll to the blocked-app notice, choose **Open Anyway**, and confirm **Open**. Follow [Apple's instructions](https://support.apple.com/en-us/102445). This is your decision for this app; do not disable Gatekeeper or remove quarantine. If macOS reports malware, corruption or a revoked app, stop and investigate. Managed Mac policies may prevent authorization.
@@ -48,8 +48,8 @@ Uninstallation and preserved synthetic sessions/exports were verified. Upgrades
The published cask above remains 0.3.0-preview.1. Source now targets **0.3.1/build 6**; [capture reliability](native-capture-reliability.md) separates candidate tests from the older binary. From clean, current `main`, choose an unused preview matching `config/version.json`; the next candidate is:
```sh
-gh workflow run preview-release.yml --repo Brendan-Lim/ContextLens --ref main -f version=0.3.1-preview.1
-gh run list --repo Brendan-Lim/ContextLens --workflow preview-release.yml
+gh workflow run preview-release.yml --repo bstack-tools/ContextLens --ref main -f version=0.3.1-preview.1
+gh run list --repo bstack-tools/ContextLens --workflow preview-release.yml
```
The manually dispatched job runs all deterministic CI checks: Swift/Python regressions, schemas/packages, replays, real-bundle portability rejection, development packaging and owned browser fixtures. It builds again using `scripts/build-app.sh --preview VERSION --output DIRECTORY`, which forces ad-hoc signing even if an Apple identity/environment variable exists. No Apple secrets, keychain import, notarytool, stapler, Gatekeeper exception or quarantine manipulation is involved in the preview workflow.
diff --git a/docs/releasing.md b/docs/releasing.md
index 0de57d0..3f0dd5b 100644
--- a/docs/releasing.md
+++ b/docs/releasing.md
@@ -22,7 +22,7 @@ Configure these seven GitHub Actions repository secrets using GitHub's encrypted
| `ASC_KEY_ID` | App Store Connect API key ID |
| `ASC_ISSUER_ID` | App Store Connect team issuer UUID |
-For example, `base64 < /secure/location/developer-id.p12 | gh secret set DEVELOPER_ID_P12_BASE64 --repo Brendan-Lim/ContextLens` reads the certificate without printing it. Use an interactive secret prompt for passwords. Configure real credentials only; there is no dummy/ad-hoc production mode.
+For example, `base64 < /secure/location/developer-id.p12 | gh secret set DEVELOPER_ID_P12_BASE64 --repo bstack-tools/ContextLens` reads the certificate without printing it. Use an interactive secret prompt for passwords. Configure real credentials only; there is no dummy/ad-hoc production mode.
The workflow creates an isolated temporary keychain with a random masked password, imports only the intended signing identity, stores notarytool credentials there, removes temporary secret files, and restores the keychain search list/deletes the temporary keychain in an `always()` cleanup step. Scripts intentionally avoid shell tracing. No signing or private entitlement material is an artifact.
@@ -33,8 +33,8 @@ The workflow creates an isolated temporary keychain with a random masked passwor
3. Dispatch the release workflow. For the current metadata the command will be:
```sh
- gh workflow run release.yml --repo Brendan-Lim/ContextLens --ref main -f version=0.3.1
- gh run list --repo Brendan-Lim/ContextLens --workflow release.yml
+ gh workflow run release.yml --repo bstack-tools/ContextLens --ref main -f version=0.3.1
+ gh run list --repo bstack-tools/ContextLens --workflow release.yml
```
This command is prepared, **not yet exercised with real signing credentials**.
diff --git a/docs/screenshot-kit/README.md b/docs/screenshot-kit/README.md
index 9989918..3e9a0db 100644
--- a/docs/screenshot-kit/README.md
+++ b/docs/screenshot-kit/README.md
@@ -2,7 +2,7 @@
The README shows only genuine screenshots of the current app and the real Finder installer window. This kit describes the seven approved images, how to take replacements, and how to check them before publication. Generated, mocked-up or edited UI is never acceptable. For future replacements, capture native 2× pixels and remove metadata without changing them; review each exact file with the owner. Preserve the integrated seven files byte for byte, including their original aspect ratios.
-**Status (9 November 2026): all seven genuine native Retina 2× screenshots are owner-approved and integrated.** Exact sanitized files are in [docs/media/screens](../media/screens/), with reviewed hashes in [the publication policy](../../config/publication-policy.json). They were captured in [run 42588372941](https://github.com/Brendan-Lim/ContextLens/actions/runs/42588372941) and integrated through [PR #3](https://github.com/Brendan-Lim/ContextLens/pull/3). Originals remain private. The separate [official candidate baseline](../official-release-preparation.md) passed 14 native engineering cases; five human security cases remain pending. Product screenshots do not attest to first-launch security.
+**Status (9 November 2026): all seven genuine native Retina 2× screenshots are owner-approved and integrated.** Exact sanitized files are in [docs/media/screens](../media/screens/), with reviewed hashes in [the publication policy](../../config/publication-policy.json). They were captured in [run 42588372941](https://github.com/bstack-tools/ContextLens/actions/runs/42588372941) and integrated through [PR #3](https://github.com/bstack-tools/ContextLens/pull/3). Originals remain private. The separate [official candidate baseline](../official-release-preparation.md) passed 14 native engineering cases; five human security cases remain pending. Product screenshots do not attest to first-launch security.
## Where to take them
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index c63932b..45dfa84 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -2,9 +2,9 @@
## Binary downloads and Homebrew
-The current download is the preview [`v0.3.0-preview.1`](https://github.com/Brendan-Lim/ContextLens/releases/tag/v0.3.0-preview.1) (ZIP), also installable with `brew install --cask Brendan-Lim/tap/contextlens-preview`. Both are ad-hoc signed and not notarized by Apple. The stable DMG and the `contextlens` cask appear only after v0.3.1 passes [interactive acceptance](release-acceptance/README.md) and is published; until then, any stable cask template is not an installable package. [Homebrew channels](homebrew.md).
+The current download is the preview [`v0.3.0-preview.1`](https://github.com/bstack-tools/ContextLens/releases/tag/v0.3.0-preview.1) (ZIP), also installable with `brew install --cask Brendan-Lim/tap/contextlens-preview`. Both are ad-hoc signed and not notarized by Apple. The stable DMG and the `contextlens` cask appear only after v0.3.1 passes [interactive acceptance](release-acceptance/README.md) and is published; until then, any stable cask template is not an installable package. [Homebrew channels](homebrew.md).
-ContextLens is built for macOS 14 Sonoma and later on Apple Silicon. Automated checks run on macOS 15 and macOS 26; macOS 14 itself has not been tested at runtime yet, so please [report](https://github.com/Brendan-Lim/ContextLens/issues) anything that breaks there.
+ContextLens is built for macOS 14 Sonoma and later on Apple Silicon. Automated checks run on macOS 15 and macOS 26; macOS 14 itself has not been tested at runtime yet, so please [report](https://github.com/bstack-tools/ContextLens/issues) anything that breaks there.
If a future install conflicts with an existing `ContextLens.app` or CLI, preserve your current app first and inspect `brew list --cask contextlens` and `command -v contextlens-cli`. Do not use `--force` to overwrite a development copy. Normal uninstall must not delete local sessions or exports.
@@ -44,7 +44,7 @@ Reconnect the installed app manually:
The expected result is verified access and a working window capture; the Settings switch alone is not proof. Other API errors can have different causes.
-If access still fails, confirm the running app's path. Recent builds show **Running copy**, **Copy and signing details**, and **Show This Copy in Finder** beside the error. Note the app version/build, macOS version and exact error for a [bug report](https://github.com/Brendan-Lim/ContextLens/issues), keeping private logs and screen content local. See [permission diagnostics](permissions.md#interpret-the-apps-result) for the meanings of unverified, denied and failed checks. This procedure changes only ContextLens's permission entry; keep macOS security protections enabled.
+If access still fails, confirm the running app's path. Recent builds show **Running copy**, **Copy and signing details**, and **Show This Copy in Finder** beside the error. Note the app version/build, macOS version and exact error for a [bug report](https://github.com/bstack-tools/ContextLens/issues), keeping private logs and screen content local. See [permission diagnostics](permissions.md#interpret-the-apps-result) for the meanings of unverified, denied and failed checks. This procedure changes only ContextLens's permission entry; keep macOS security protections enabled.
### Other capture issues