Repository navigation
Releases
Sentry v2.0.1 — Windows Stable
Sentry v2.0.1 — Windows Stable
An update from v2.0.0. It adds a choice of run depth (Fast or Full), a default run time limit, reasoning effort for every agent and new sentry cli settings commands, and fixes three bugs found by a QA run. There is no database migration: your projects, runs, history and provider settings are kept. Already on v2.0.0? Follow “Update an existing installation” below. Fresh installs follow the numbered steps in order.
Supported installation: Windows 11 x64 + WSL2, Ubuntu preferred. This is an unsigned ZIP with online Linux bootstrap, not an MSI/MSIX or offline installer. Setup requires internet and the Linux prerequisites below. Provider credentials are configured in Desktop; provider usage charges are separate.
What's new in 2.0.1
- Run depth: choose Fast (at most 3 planned checks) or Full (the default, as many as the time window allows, up to 8) on the project page or with
run start --depth fast|full. Both use the same window and the same extra passes, and the depth is shown on the run and in Findings by revision. - Run time limit: Settings → Runtime sets the window every run gets: 3 hours (default), 6 hours, No limit (7 days) or a custom value from 10 minutes. It is a ceiling, not a target, and it decides which extra passes still have time. The longest window a run can be given is now 7 days (it was 12 hours).
- Reasoning effort per agent in Settings → Providers, shown on the Environment page and on the project page's agent cards.
- CLI:
settings show,settings effort <agent> <level|default>andsettings run-limit <default|3h|6h|none|90m|12h>;run listandrun statusreport each run'sdepthandtimeLimitMs; the help lists every command. - Fixes: a symlink whose target contains a backslash is copied exactly on Linux and macOS; a finding title can no longer forge a status line in the human-readable log; a stored artifact whose path names the data root is refused before its database row is deleted.
- Interface: the ChatGPT sign-in choice is a two-button control; more Bulgarian translations; calmer yellow stripes where an agent hit a warning; the Details page no longer shows elapsed time.
1. WSL2 and Ubuntu
Run in PowerShell:
wsl.exe --list --verboseIf Ubuntu already exists, is initialized, and shows VERSION 2, keep it and continue. Otherwise run in PowerShell as Administrator:
wsl.exe --install -d UbuntuRestart if Windows requests it. Then use normal PowerShell:
wsl.exe --set-version Ubuntu 2
wsl.exe -d UbuntuComplete the Linux username/password prompts, then type exit to return to PowerShell. You do not need to remove WSL to install or update Sentry. See Microsoft WSL installation.
2. Linux prerequisites — commands from PowerShell
Skip this block if the selected Ubuntu already has Node >=22, pnpm 9.12.3, systemd user services, bubblewrap, and socat. Otherwise paste it into PowerShell. It installs packages inside Ubuntu using WSL root and the official NodeSource Node 22 repository when needed. If your distro has another name, change the Ubuntu selection in these blocks consistently.
& {
$ErrorActionPreference = 'Stop'
function Invoke-UbuntuRoot {
param([string[]]$LinuxArguments)
& wsl.exe -d Ubuntu -u root -- @LinuxArguments
if ($LASTEXITCODE -ne 0) { throw 'Ubuntu prerequisite installation stopped. Resolve the error before continuing.' }
}
function Get-UbuntuVersion {
param([string]$Tool)
try {
$version = & wsl.exe -d Ubuntu -- $Tool --version 2>$null
if ($LASTEXITCODE -eq 0) { return ([string]$version).Trim() }
} catch { }
return ''
}
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'update')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'ca-certificates', 'curl', 'bubblewrap', 'socat', 'systemd', 'systemd-sysv')
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22) {
Invoke-UbuntuRoot -LinuxArguments @('install', '-d', '-m', '700', '/root/.cache/sentry-bootstrap')
Invoke-UbuntuRoot -LinuxArguments @('curl', '-fsSL', 'https://deb.nodesource.com/setup_22.x', '-o', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('bash', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'nodejs')
}
$pnpmVersion = Get-UbuntuVersion -Tool 'pnpm'
if ($pnpmVersion -cne '9.12.3') {
Invoke-UbuntuRoot -LinuxArguments @('npm', 'install', '--global', 'pnpm@9.12.3')
}
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22 -or
(Get-UbuntuVersion -Tool 'pnpm') -cne '9.12.3') {
throw 'Node >=22 or pnpm 9.12.3 is unavailable inside Ubuntu. Installation stopped.'
}
& wsl.exe -d Ubuntu -- systemctl --user show-environment
if ($LASTEXITCODE -ne 0) {
throw 'Ubuntu systemd user services are unavailable. Follow the systemd guidance below, then rerun this block.'
}
Write-Host 'Ubuntu prerequisites installed. Continue with Install Sentry below.'
}If systemd user services are unavailable, follow Microsoft systemd guidance, preserving existing WSL configuration, and rerun the check.
3. Fresh install — download, verify, setup, and open
Paste the entire block into normal PowerShell from any folder, including System32. It automatically downloads the exact ZIP and checksum, verifies the pinned ZIP hash, manifest hash, full source identity, and every distribution file before executing the launcher, extracts into a separate version/source directory, sets up the matching runtime, provisions the pinned tools, and opens Desktop. A failure stops subsequent steps. Existing matching installation files are verified and reused; a tampered directory is refused.
& {
$ErrorActionPreference = 'Stop'
$name = 'sentry-2.0.1-3db5b49985a8-windows-x64'
$expectedHash = '29d06240ce5079161144b9879481c6ccdcfffa282b95ecf224bdfbd16c9a53ce'
$expectedManifest = '326ec379f62723cd2b4874e28abae8b748eb72b1495575d738a4e5be195d4619'
$source = '3db5b49985a8218350d227e9dbe87ff232f35a5e'
$download = Join-Path $env:USERPROFILE 'Downloads\Sentry-v2.0.1'
$destination = Join-Path $env:LOCALAPPDATA 'Sentry\releases'
$installation = Join-Path $destination $name
$zip = Join-Path $download ($name + '.zip')
$checksum = $zip + '.sha256'
$url = 'https://github.com/Mert1026/Sentry/releases/download/v2.0.1/'
New-Item -ItemType Directory -Path $download, $destination -Force | Out-Null
Write-Host 'Downloading the official ZIP and checksum...'
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip') -OutFile $zip
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip.sha256') -OutFile $checksum
if (-not (Test-Path -LiteralPath $zip -PathType Leaf) -or
-not (Test-Path -LiteralPath $checksum -PathType Leaf)) {
throw 'The ZIP or checksum file is missing. Installation stopped.'
}
$sidecarHash = ((Get-Content -LiteralPath $checksum -Raw).Trim() -split '\s+')[0]
$actualHash = (Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash
if ($sidecarHash -notmatch '^[a-fA-F0-9]{64}$' -or
$sidecarHash -ine $expectedHash -or $actualHash -ine $expectedHash) {
throw 'Checksum verification failed. Installation stopped.'
}
if (-not (Test-Path -LiteralPath $installation)) {
Expand-Archive -LiteralPath $zip -DestinationPath $destination
}
$manifestPath = Join-Path $installation 'distribution.json'
if ((Get-FileHash -LiteralPath $manifestPath -Algorithm SHA256).Hash -ine $expectedManifest) {
throw 'Distribution manifest mismatch. Installation stopped.'
}
$manifest = Get-Content -LiteralPath $manifestPath -Raw | ConvertFrom-Json
if ($manifest.sourceCommit -cne $source -or $manifest.version -cne '2.0.1' -or
$manifest.runtimeProtocol -ne 1 -or $manifest.targetPlatform -cne 'windows-x64') {
throw 'Release identity mismatch. Installation stopped.'
}
foreach ($file in $manifest.files.PSObject.Properties) {
$path = Join-Path $installation $file.Name
if ((Get-FileHash -LiteralPath $path -Algorithm SHA256).Hash -ine $file.Value) {
throw ('Distribution file mismatch: ' + $file.Name)
}
}
Write-Host 'Approved checksum, manifest, source identity and files verified.'
$launcher = Join-Path $installation 'sentry.ps1'
foreach ($step in @('version', 'setup', 'tools', 'open')) {
Write-Host ('Sentry: ' + $step)
if ($step -in @('setup', 'tools')) {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step -Distro Ubuntu
} else {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step
}
if ($LASTEXITCODE -ne 0) {
throw ('Sentry ' + $step + ' stopped. Resolve the reported error, then paste this block again.')
}
}
Write-Host ('Installed at: ' + $installation)
Write-Host 'Check Environment is Connected. Provider requests can incur charges.'
$env:Path += ";$env:LOCALAPPDATA\Sentry\bin"
Write-Host "Use sentry open, sentry status, sentry doctor or sentry version from any folder."
}Keep the installed directory under %LOCALAPPDATA%\Sentry\releases; it is the application. Configure Settings → Providers, then check Environment is Connected and provider readiness. Installation/readiness checks do not start paid QA. A capabilities handshake alone does not establish runtim...
Sentry v2.0.0 — Windows Stable
Sentry v2.0.0 — Windows Stable
Major release. It adds staged QA, re-testing of earlier findings, project profiles, a library of 59 toolchain packs, ChatGPT as an opt-in agent, CLI parity and Bulgarian interface translations, and it removes the 1.x merge, verification and issue features.
Breaking change: database migration 7 is one-way. It drops the merge, verification, issue and retest tables and legacy retest runs. Full and Targeted runs, findings, evidence and exports are kept; issue and retest history is not. Back up your data before updating (step 4) and do not downgrade a migrated database to 1.x. Existing users: follow “Update an existing installation” below.
Supported installation: Windows 11 x64 + WSL2, Ubuntu preferred. This is an unsigned ZIP with online Linux bootstrap, not an MSI/MSIX or offline installer. Setup requires internet and the Linux prerequisites below. Provider credentials are configured in Desktop; provider usage charges are separate.
What's new
- Staged QA flow with a frozen plan, per-check investigation, deepening, a hazard sweep and a report.
- Re-test of earlier findings on the current revision, answered Passed, Not passed or Could not complete with the agent's reason.
- Findings by revision and a project profile with per-agent notes.
- Toolchains: 59 packs, project-pinned versions, custom add-ons and a per-run option to allow tool and SDK downloads.
- ChatGPT as an opt-in agent next to OpenCode, DeepSeek and GLM.
- CLI parity:
run start --retest/--profile/--tools/--revision,project findings|profile|profile-build,toolchain status|install|remove. - Bulgarian translations including statuses and generated text; containment fixes for project copies and recovery.
Removed: run merge, issue and retest CLI commands and the merge, verification and issue pages.
1. WSL2 and Ubuntu
Run in PowerShell:
wsl.exe --list --verboseIf Ubuntu already exists, is initialized, and shows VERSION 2, keep it and continue. Otherwise run in PowerShell as Administrator:
wsl.exe --install -d UbuntuRestart if Windows requests it. Then use normal PowerShell:
wsl.exe --set-version Ubuntu 2
wsl.exe -d UbuntuComplete the Linux username/password prompts, then type exit to return to PowerShell. You do not need to remove WSL to install or update Sentry. See Microsoft WSL installation.
2. Linux prerequisites — commands from PowerShell
Skip this block if the selected Ubuntu already has Node >=22, pnpm 9.12.3, systemd user services, bubblewrap, and socat. Otherwise paste it into PowerShell. It installs packages inside Ubuntu using WSL root and the official NodeSource Node 22 repository when needed. If your distro has another name, change the Ubuntu selection in these blocks consistently.
& {
$ErrorActionPreference = 'Stop'
function Invoke-UbuntuRoot {
param([string[]]$LinuxArguments)
& wsl.exe -d Ubuntu -u root -- @LinuxArguments
if ($LASTEXITCODE -ne 0) { throw 'Ubuntu prerequisite installation stopped. Resolve the error before continuing.' }
}
function Get-UbuntuVersion {
param([string]$Tool)
try {
$version = & wsl.exe -d Ubuntu -- $Tool --version 2>$null
if ($LASTEXITCODE -eq 0) { return ([string]$version).Trim() }
} catch { }
return ''
}
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'update')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'ca-certificates', 'curl', 'bubblewrap', 'socat', 'systemd', 'systemd-sysv')
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22) {
Invoke-UbuntuRoot -LinuxArguments @('install', '-d', '-m', '700', '/root/.cache/sentry-bootstrap')
Invoke-UbuntuRoot -LinuxArguments @('curl', '-fsSL', 'https://deb.nodesource.com/setup_22.x', '-o', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('bash', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'nodejs')
}
$pnpmVersion = Get-UbuntuVersion -Tool 'pnpm'
if ($pnpmVersion -cne '9.12.3') {
Invoke-UbuntuRoot -LinuxArguments @('npm', 'install', '--global', 'pnpm@9.12.3')
}
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22 -or
(Get-UbuntuVersion -Tool 'pnpm') -cne '9.12.3') {
throw 'Node >=22 or pnpm 9.12.3 is unavailable inside Ubuntu. Installation stopped.'
}
& wsl.exe -d Ubuntu -- systemctl --user show-environment
if ($LASTEXITCODE -ne 0) {
throw 'Ubuntu systemd user services are unavailable. Follow the systemd guidance below, then rerun this block.'
}
Write-Host 'Ubuntu prerequisites installed. Continue with Install Sentry below.'
}If systemd user services are unavailable, follow Microsoft systemd guidance, preserving existing WSL configuration, and rerun the check.
3. Fresh install — download, verify, setup, and open
Paste the entire block into normal PowerShell from any folder, including System32. It automatically downloads the exact ZIP and checksum, verifies the pinned ZIP hash, manifest hash, full source identity, and every distribution file before executing the launcher, extracts into a separate version/source directory, sets up the matching runtime, provisions the pinned tools, and opens Desktop. A failure stops subsequent steps. Existing matching installation files are verified and reused; a tampered directory is refused.
& {
$ErrorActionPreference = 'Stop'
$name = 'sentry-2.0.0-88eac224c735-windows-x64'
$expectedHash = 'dc30a28aa2c256edc0a172a267d5c800b8dbb2578e105d37ea45e42cc7b6361e'
$expectedManifest = '7aa9da1773b14144374de91ce902de96db3fd75eb2f2f7ad6fa6d9836169c60d'
$source = '88eac224c7357028b2d2aa440dbcdefd984f0d58'
$download = Join-Path $env:USERPROFILE 'Downloads\Sentry-v2.0.0'
$destination = Join-Path $env:LOCALAPPDATA 'Sentry\releases'
$installation = Join-Path $destination $name
$zip = Join-Path $download ($name + '.zip')
$checksum = $zip + '.sha256'
$url = 'https://github.com/Mert1026/Sentry/releases/download/v2.0.0/'
New-Item -ItemType Directory -Path $download, $destination -Force | Out-Null
Write-Host 'Downloading the official ZIP and checksum...'
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip') -OutFile $zip
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip.sha256') -OutFile $checksum
if (-not (Test-Path -LiteralPath $zip -PathType Leaf) -or
-not (Test-Path -LiteralPath $checksum -PathType Leaf)) {
throw 'The ZIP or checksum file is missing. Installation stopped.'
}
$sidecarHash = ((Get-Content -LiteralPath $checksum -Raw).Trim() -split '\s+')[0]
$actualHash = (Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash
if ($sidecarHash -notmatch '^[a-fA-F0-9]{64}$' -or
$sidecarHash -ine $expectedHash -or $actualHash -ine $expectedHash) {
throw 'Checksum verification failed. Installation stopped.'
}
if (-not (Test-Path -LiteralPath $installation)) {
Expand-Archive -LiteralPath $zip -DestinationPath $destination
}
$manifestPath = Join-Path $installation 'distribution.json'
if ((Get-FileHash -LiteralPath $manifestPath -Algorithm SHA256).Hash -ine $expectedManifest) {
throw 'Distribution manifest mismatch. Installation stopped.'
}
$manifest = Get-Content -LiteralPath $manifestPath -Raw | ConvertFrom-Json
if ($manifest.sourceCommit -cne $source -or $manifest.version -cne '2.0.0' -or
$manifest.runtimeProtocol -ne 1 -or $manifest.targetPlatform -cne 'windows-x64') {
throw 'Release identity mismatch. Installation stopped.'
}
foreach ($file in $manifest.files.PSObject.Properties) {
$path = Join-Path $installation $file.Name
if ((Get-FileHash -LiteralPath $path -Algorithm SHA256).Hash -ine $file.Value) {
throw ('Distribution file mismatch: ' + $file.Name)
}
}
Write-Host 'Approved checksum, manifest, source identity and files verified.'
$launcher = Join-Path $installation 'sentry.ps1'
foreach ($step in @('version', 'setup', 'tools', 'open')) {
Write-Host ('Sentry: ' + $step)
if ($step -in @('setup', 'tools')) {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step -Distro Ubuntu
} else {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step
}
if ($LASTEXITCODE -ne 0) {
throw ('Sentry ' + $step + ' stopped. Resolve the reported error, then paste this block again.')
}
}
Write-Host ('Installed at: ' + $installation)
Write-Host 'Check Environment is Connected. Provider requests can incur charges.'
$env:Path += ";$env:LOCALAPPDATA\Sentry\bin"
Write-Host "Use sentry open, sentry status, sentry doctor or sentry version from any folder."
}Keep the installed directory under %LOCALAPPDATA%\Sentry\releases; it is the application. Configure Settings → Providers, then check Environment is Connected and provider readiness. Installation/readiness checks do not start paid QA. A capabilities handshake alone does not establish runtime/provider readiness.
4. Update an existing installation — 1.x to v2.0.0
This update migrates your database one way: issue, retest and merge history from 1.x is dropped, and the migrated database cannot be used by 1.x. The backup below is your only way back. Run it first and keep it until you have checked your own history.
If your older installation has no registere...
Sentry 1.1.0-beta.1
Sentry 1.1.0-beta.1
A beta of the next minor release. The product identity still reports 1.0.2; no version numbers changed.
What's new
- Staged QA flow: frozen plan, host-driven per-check investigation, deepening, hazard sweep and report, with a proof gate and an operation receipt.
- Project profile: per-agent orientation notes for a project, a "Use project profile" run option and a profile-usage record on each run. Notes are labelled unverified and never store past findings.
- Missing-tools ladder: run it, otherwise a labelled
[replica], otherwise a labelled[traced]fallback. Replica and trace results can never certify a pass. - Toolchain packs (Settings, Toolchains): host-side installs of Python (uv), .NET, Rust, Go and Java, mounted read-only into OpenCode tool shells. Each run uses the project's pinned version (global.json, target framework, go.mod, .python-version, rust-toolchain, pom) and falls back to the newest installed version.
- Tool and SDK downloads: a per-run option widens the shell allowlist to official vendor hosts. Package registries stay allowed in every run.
- Sandbox fixes for OpenCode tool shells: Windows drives,
/mntand the WSL interop socket are hidden; .NET lock files work; .NET build servers no longer stall commands until the 300s tool timeout.
Upgrading from 1.0.2
- Migration 7 is one-way. It drops the merge, verification, issue and retest tables and legacy retest runs. Full and Targeted runs, findings, evidence and exports are kept. Back up the data folder first if issue or retest history matters.
- The CLI commands
run merge,issue,retestandverifywere removed. - Runtime protocol 1, schemas (new fields are optional), settings, secrets and provider pins are unchanged.
- Install from this tag as described in
docs/beta/updating.md. Tag installs are pinned;sentry updaterefuses on a detached tag.
Known limits
- Toolchain mounts and version pins are OpenCode only; DeepSeek has no tool downloads.
- Rust, Go and Java installers are unit-tested with a fake runner but not yet run end to end. Python and .NET have been.
- No Standard/Unrestricted run-mode switch yet.
- Gradle projects and
pyproject.tomlranges are not read for version pins. - Which checks an agent plans varies between runs of the same project.
Full details: CHANGELOG.md and docs/beta/compatibility.md. Source only; no Windows archive is attached to this pre-release.
Sentry v1.0.2 — Windows Stable
Sentry v1.0.2 — Windows Stable
The production CLI is included in this release. Install once, open Desktop, and use sentry cli from PowerShell or Command Prompt to import/update projects, start Full or Targeted QA, inspect/cancel runs, and retrieve or export results. Commands use the same projects and runs as Desktop. The included Electron runtime runs the CLI; no Windows Node, pnpm, Git, or source checkout is required.
This patch combines the packaged CLI with consolidated current documentation. Existing v1.0.0/v1.0.1 archives remain unchanged and do not contain this packaged CLI. Existing users: follow “Update an existing installation” below.
Supported installation: Windows 11 x64 + WSL2, Ubuntu preferred. This is an unsigned ZIP with online Linux bootstrap, not an MSI/MSIX or offline installer. Setup requires internet and the Linux prerequisites below. Provider credentials are configured in Desktop; provider usage charges are separate.
1. WSL2 and Ubuntu
Run in PowerShell:
wsl.exe --list --verboseIf Ubuntu already exists, is initialized, and shows VERSION 2, keep it and continue. Otherwise run in PowerShell as Administrator:
wsl.exe --install -d UbuntuRestart if Windows requests it. Then use normal PowerShell:
wsl.exe --set-version Ubuntu 2
wsl.exe -d UbuntuComplete the Linux username/password prompts, then type exit to return to PowerShell. You do not need to remove WSL to install or update Sentry. See Microsoft WSL installation.
2. Linux prerequisites — commands from PowerShell
Skip this block if the selected Ubuntu already has Node >=22, pnpm 9.12.3, systemd user services, bubblewrap, and socat. Otherwise paste it into PowerShell. It installs packages inside Ubuntu using WSL root and the official NodeSource Node 22 repository when needed. If your distro has another name, change the Ubuntu selection in these blocks consistently.
& {
$ErrorActionPreference = 'Stop'
function Invoke-UbuntuRoot {
param([string[]]$LinuxArguments)
& wsl.exe -d Ubuntu -u root -- @LinuxArguments
if ($LASTEXITCODE -ne 0) { throw 'Ubuntu prerequisite installation stopped. Resolve the error before continuing.' }
}
function Get-UbuntuVersion {
param([string]$Tool)
try {
$version = & wsl.exe -d Ubuntu -- $Tool --version 2>$null
if ($LASTEXITCODE -eq 0) { return ([string]$version).Trim() }
} catch { }
return ''
}
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'update')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'ca-certificates', 'curl', 'bubblewrap', 'socat', 'systemd', 'systemd-sysv')
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22) {
Invoke-UbuntuRoot -LinuxArguments @('install', '-d', '-m', '700', '/root/.cache/sentry-bootstrap')
Invoke-UbuntuRoot -LinuxArguments @('curl', '-fsSL', 'https://deb.nodesource.com/setup_22.x', '-o', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('bash', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'nodejs')
}
$pnpmVersion = Get-UbuntuVersion -Tool 'pnpm'
if ($pnpmVersion -cne '9.12.3') {
Invoke-UbuntuRoot -LinuxArguments @('npm', 'install', '--global', 'pnpm@9.12.3')
}
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22 -or
(Get-UbuntuVersion -Tool 'pnpm') -cne '9.12.3') {
throw 'Node >=22 or pnpm 9.12.3 is unavailable inside Ubuntu. Installation stopped.'
}
& wsl.exe -d Ubuntu -- systemctl --user show-environment
if ($LASTEXITCODE -ne 0) {
throw 'Ubuntu systemd user services are unavailable. Follow the systemd guidance below, then rerun this block.'
}
Write-Host 'Ubuntu prerequisites installed. Continue with Install Sentry below.'
}If systemd user services are unavailable, follow Microsoft systemd guidance, preserving existing WSL configuration, and rerun the check.
3. Fresh install — download, verify, setup, and open
Paste the entire block into normal PowerShell from any folder, including System32. It automatically downloads the exact ZIP and checksum, verifies the pinned ZIP hash, manifest hash, full source identity, and every distribution file before executing the launcher, extracts into a separate version/source directory, sets up the matching runtime, provisions the pinned tools, and opens Desktop. A failure stops subsequent steps. Existing matching installation files are verified and reused; a tampered directory is refused.
& {
$ErrorActionPreference = 'Stop'
$name = 'sentry-1.0.2-2640efcd7874-windows-x64'
$expectedHash = '5265713af248297c543bf0d41093258bd0e7d8c177e0b1c544e733750347286f'
$expectedManifest = 'f5b2e5d93adb194a319df653502e8fa21a032b4542f4a4e9e6b7c87d34730ab3'
$source = '2640efcd78744cb02c517a405e648722e662bd60'
$download = Join-Path $env:USERPROFILE 'Downloads\Sentry-v1.0.2'
$destination = Join-Path $env:LOCALAPPDATA 'Sentry\releases'
$installation = Join-Path $destination $name
$zip = Join-Path $download ($name + '.zip')
$checksum = $zip + '.sha256'
$url = 'https://github.com/Mert1026/Sentry/releases/download/v1.0.2/'
New-Item -ItemType Directory -Path $download, $destination -Force | Out-Null
Write-Host 'Downloading the official ZIP and checksum...'
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip') -OutFile $zip
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip.sha256') -OutFile $checksum
if (-not (Test-Path -LiteralPath $zip -PathType Leaf) -or
-not (Test-Path -LiteralPath $checksum -PathType Leaf)) {
throw 'The ZIP or checksum file is missing. Installation stopped.'
}
$sidecarHash = ((Get-Content -LiteralPath $checksum -Raw).Trim() -split '\s+')[0]
$actualHash = (Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash
if ($sidecarHash -notmatch '^[a-fA-F0-9]{64}$' -or
$sidecarHash -ine $expectedHash -or $actualHash -ine $expectedHash) {
throw 'Checksum verification failed. Installation stopped.'
}
if (-not (Test-Path -LiteralPath $installation)) {
Expand-Archive -LiteralPath $zip -DestinationPath $destination
}
$manifestPath = Join-Path $installation 'distribution.json'
if ((Get-FileHash -LiteralPath $manifestPath -Algorithm SHA256).Hash -ine $expectedManifest) {
throw 'Distribution manifest mismatch. Installation stopped.'
}
$manifest = Get-Content -LiteralPath $manifestPath -Raw | ConvertFrom-Json
if ($manifest.sourceCommit -cne $source -or $manifest.version -cne '1.0.2' -or
$manifest.runtimeProtocol -ne 1 -or $manifest.targetPlatform -cne 'windows-x64') {
throw 'Release identity mismatch. Installation stopped.'
}
foreach ($file in $manifest.files.PSObject.Properties) {
$path = Join-Path $installation $file.Name
if ((Get-FileHash -LiteralPath $path -Algorithm SHA256).Hash -ine $file.Value) {
throw ('Distribution file mismatch: ' + $file.Name)
}
}
Write-Host 'Approved checksum, manifest, source identity and files verified.'
$launcher = Join-Path $installation 'sentry.ps1'
foreach ($step in @('version', 'setup', 'tools', 'open')) {
Write-Host ('Sentry: ' + $step)
if ($step -in @('setup', 'tools')) {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step -Distro Ubuntu
} else {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step
}
if ($LASTEXITCODE -ne 0) {
throw ('Sentry ' + $step + ' stopped. Resolve the reported error, then paste this block again.')
}
}
Write-Host ('Installed at: ' + $installation)
Write-Host 'Check Environment is Connected. Provider requests can incur charges.'
$env:Path += ";$env:LOCALAPPDATA\Sentry\bin"
Write-Host "Use sentry open, sentry status, sentry doctor or sentry version from any folder."
}Keep the installed directory under %LOCALAPPDATA%\Sentry\releases; it is the application. Configure Settings → Providers, then check Environment is Connected and provider readiness. Installation/readiness checks do not start paid QA. A capabilities handshake alone does not establish runtime/provider readiness.
4. Update an existing installation — v1.0.0/v1.0.1 to v1.0.2
If your older installation has no registered sentry command, replace & sentry stop in the backup block with & powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\path\to\previous-installation\sentry.ps1" stop, using its actual absolute path.
- Finish active QA/retests or explicitly cancel them, and wait until they settle. Check Environment for your actual distro/data root. Keep the previous matched archive/runtime.
- In PowerShell, run the stopped-backup block below. It uses the standard current-user profile/data locations; change
$distroand$linuxDatato the actual values if customized. Allow enough space for a full backup plus the new archive and runtime. You can select another backup drive by changing$backup. - After backup succeeds, run the same complete v1.0.2 install block in step 3. It selects the new archive through setup and command registration. Do not extract over the old version or delete WSL/user data.
- Open a new PowerShell window, run the verification commands below, and inspect existing projects, completed history/results, exports, and provider settings in Desktop. Retain the stopped backup and previous ma...
Sentry v1.0.1 — Windows Stable
Sentry v1.0.1 — Windows Stable
This patch fixes imports of projects containing unreadable generated caches and installs the Windows command during setup.
- Python caches/environments and Next/Nuxt build output are skipped before new imports and updates.
- Required unreadable paths report their permission error and path. Disk exhaustion provides storage guidance.
- Successful setup registers
sentryfor PowerShell and Command Prompt. Existing revision hashes remain compatible.
Supported: Windows 11 x64 + WSL2 + Ubuntu. This is an unsigned ZIP with online runtime bootstrap. Windows Node/pnpm/Git are not required. Internet is required for setup and provider tools. Native Linux Desktop is deferred.
1. WSL and Ubuntu — only if missing
Check from PowerShell:
wsl.exe --list --verboseIf Ubuntu is already initialized with VERSION 2, continue to step 2. Otherwise, in PowerShell as Administrator:
wsl.exe --install -d UbuntuRestart Windows if requested. In normal PowerShell, initialize Ubuntu:
wsl.exe --set-version Ubuntu 2
wsl.exe -d UbuntuComplete the Linux username/password prompts, then type exit to return to PowerShell. Existing Ubuntu installations do not need removal. See Microsoft's WSL installation guide.
2. Ubuntu prerequisites
Skip this block if Ubuntu already has Linux Node >=22, pnpm 9.12.3, systemd user services, bubblewrap and socat. Otherwise paste this into PowerShell. It changes packages inside Ubuntu, using root through WSL and the official NodeSource Node 22 repository when needed:
& {
$ErrorActionPreference = 'Stop'
function Invoke-UbuntuRoot {
param([string[]]$LinuxArguments)
& wsl.exe -d Ubuntu -u root -- @LinuxArguments
if ($LASTEXITCODE -ne 0) { throw 'Ubuntu prerequisite installation stopped. Resolve the error before continuing.' }
}
function Get-UbuntuVersion {
param([string]$Tool)
try {
$version = & wsl.exe -d Ubuntu -- $Tool --version 2>$null
if ($LASTEXITCODE -eq 0) { return ([string]$version).Trim() }
} catch { }
return ''
}
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'update')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'ca-certificates', 'curl', 'bubblewrap', 'socat', 'systemd', 'systemd-sysv')
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22) {
Invoke-UbuntuRoot -LinuxArguments @('install', '-d', '-m', '700', '/root/.cache/sentry-bootstrap')
Invoke-UbuntuRoot -LinuxArguments @('curl', '-fsSL', 'https://deb.nodesource.com/setup_22.x', '-o', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('bash', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'nodejs')
}
$pnpmVersion = Get-UbuntuVersion -Tool 'pnpm'
if ($pnpmVersion -cne '9.12.3') {
Invoke-UbuntuRoot -LinuxArguments @('npm', 'install', '--global', 'pnpm@9.12.3')
}
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22 -or
(Get-UbuntuVersion -Tool 'pnpm') -cne '9.12.3') {
throw 'Node >=22 or pnpm 9.12.3 is unavailable inside Ubuntu. Installation stopped.'
}
& wsl.exe -d Ubuntu -- systemctl --user show-environment
if ($LASTEXITCODE -ne 0) {
throw 'Ubuntu systemd user services are unavailable. Follow the systemd guidance below, then rerun this block.'
}
Write-Host 'Ubuntu prerequisites installed. Continue with Install Sentry below.'
}Current Ubuntu WSL installations enable systemd by default. If the block reports unavailable systemd user services, follow Microsoft's systemd guidance, preserving existing configuration, then rerun it.
3. Download, verify and install
Finish or cancel active QA before setup. Paste this entire block into normal PowerShell from any directory, including System32. It downloads both exact assets automatically, verifies the pinned checksum, manifest, source identity and every distribution file, installs the matching runtime and provider tools, then opens Desktop. Failures stop later steps. There is no manual download or cd requirement.
The archive is extracted into its own directory under %LOCALAPPDATA%\Sentry\releases. Keep that directory in place; it is the application installation. Existing matching files are verified and reused without overwriting them.
& {
$ErrorActionPreference = 'Stop'
$name = 'sentry-1.0.1-6793a9c53a33-windows-x64'
$expectedHash = 'defb07406eac22096d63330a886bf4e340d98e2d6e0d13678b0300d4c6503675'
$expectedManifest = '54512588008a1ed93e3b3d8967e819fa803529ec75625df9cbba3babf6ae2a18'
$source = '6793a9c53a336d577ac4397735d0396f558b60f0'
$download = Join-Path $env:USERPROFILE 'Downloads\Sentry-v1.0.1'
$destination = Join-Path $env:LOCALAPPDATA 'Sentry\releases'
$installation = Join-Path $destination $name
$zip = Join-Path $download ($name + '.zip')
$checksum = $zip + '.sha256'
$url = 'https://github.com/Mert1026/Sentry/releases/download/v1.0.1/'
New-Item -ItemType Directory -Path $download, $destination -Force | Out-Null
Write-Host 'Downloading the official ZIP and checksum...'
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip') -OutFile $zip
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip.sha256') -OutFile $checksum
if (-not (Test-Path -LiteralPath $zip -PathType Leaf) -or
-not (Test-Path -LiteralPath $checksum -PathType Leaf)) {
throw 'The ZIP or checksum file is missing. Installation stopped.'
}
$sidecarHash = ((Get-Content -LiteralPath $checksum -Raw).Trim() -split '\s+')[0]
$actualHash = (Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash
if ($sidecarHash -notmatch '^[a-fA-F0-9]{64}$' -or
$sidecarHash -ine $expectedHash -or $actualHash -ine $expectedHash) {
throw 'Checksum verification failed. Installation stopped.'
}
if (-not (Test-Path -LiteralPath $installation)) {
Expand-Archive -LiteralPath $zip -DestinationPath $destination
}
$manifestPath = Join-Path $installation 'distribution.json'
if ((Get-FileHash -LiteralPath $manifestPath -Algorithm SHA256).Hash -ine $expectedManifest) {
throw 'Distribution manifest mismatch. Installation stopped.'
}
$manifest = Get-Content -LiteralPath $manifestPath -Raw | ConvertFrom-Json
if ($manifest.sourceCommit -cne $source -or $manifest.version -cne '1.0.1' -or
$manifest.runtimeProtocol -ne 1 -or $manifest.targetPlatform -cne 'windows-x64') {
throw 'Release identity mismatch. Installation stopped.'
}
foreach ($file in $manifest.files.PSObject.Properties) {
$path = Join-Path $installation $file.Name
if ((Get-FileHash -LiteralPath $path -Algorithm SHA256).Hash -ine $file.Value) {
throw ('Distribution file mismatch: ' + $file.Name)
}
}
Write-Host 'Approved checksum, manifest, source identity and files verified.'
$launcher = Join-Path $installation 'sentry.ps1'
foreach ($step in @('version', 'setup', 'tools', 'open')) {
Write-Host ('Sentry: ' + $step)
if ($step -in @('setup', 'tools')) {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step -Distro Ubuntu
} else {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step
}
if ($LASTEXITCODE -ne 0) {
throw ('Sentry ' + $step + ' stopped. Resolve the reported error, then paste this block again.')
}
}
Write-Host ('Installed at: ' + $installation)
Write-Host 'Check Environment is Connected. Provider requests can incur charges.'
$env:Path += ";$env:LOCALAPPDATA\Sentry\bin"
Write-Host "Use sentry open, sentry status, sentry doctor or sentry version from any folder."
}Configure Settings → Providers and check Environment is Connected before importing a project. Provider accounts and usage charges are separate. Setup and diagnostics do not make paid QA requests.
4. Everyday commands — from any folder
sentry open
sentry status
sentry doctor
sentry version
# Stop after any active QA has settled:
sentry stopSetup registers the command in the user PATH. New terminals pick it up; the installation block refreshes it in the current PowerShell window too. If an older window cannot find it:
$env:Path += ";$env:LOCALAPPDATA\Sentry\bin"
sentry openIf you move the installed archive directory, run .\sentry.ps1 register-command from its new location. Setup from a newer verified archive selects that archive for the command.
Upgrade and compatibility
Existing v1.0.0 users install this new archive using step 3. Keep the previous matched archive/runtime for recovery; never extract over an existing installation. There is no automatic updater. Product version is 1.0.1, protocol remains 1. Schemas/migrations, credential encryption, provider/model/tool pins and project-history formats are unchanged. OpenCode 1.18.32, DeepSeek SDK 0.1.5-rc.2 and Claude Code 2.1.270 remain pinned.
Source selection does not evaluate .gitignore; local data directories remain eligible. Import retains a managed copy and immutable revision, with copy fallback when reflinks are unavailable. WSL virtual free space does not guarantee Windows backing-drive capacity. Source files and permissions are not changed by import. Windows credentials retain same-account/machine DPAPI boundaries; no aut...
Sentry v1.0.0 — Windows Stable
Sentry v1.0.0 Stable — Windows
Sentry v1.0.0 Stable — Windows Edition. This release supports Windows 11 x64
with WSL2; Ubuntu is preferred. Native Linux Desktop is deferred.
Included
- Independent OpenCode, DeepSeek and GLM through Claude Code agents, with one-,
two- or three-agent selection and Full or Targeted QA. - Managed project copies and immutable snapshots shared by the selected agents.
- Grounded findings, source/tool evidence and observable individual agent results.
- Persistent project and run history, cancellation, and JSON/log exports.
- Confirmed project removal, including managed data and history, preserving
original imported source folders. Active operations prevent removal. - Windows secure provider settings through Electron safeStorage/DPAPI, with no
plaintext persistence fallback when secure encryption is unavailable. - WSL runtime installation, matching Desktop/runtime release identity, graceful
shutdown, restart and recovery management. - Optional Windows disk-space reclamation for the selected WSL distro, with
explicit confirmation and administrator consent. Reclaimable space varies. - Hardened maintenance privilege boundary: fixed inline execution across UAC,
private operation-directory ACLs and path validation, and authenticated,
operation-specific receipts published exclusively and atomically. Existing
busy-state, cancellation, selected-disk and reconnect safeguards remain.
Historical merger/verifier components remain in the source repository; they are
not advertised as active Desktop workflows.
Install with PowerShell
Supported target: Windows 11 x64 + WSL2 + Ubuntu. Native Linux Desktop is deferred.
This is an unsigned ZIP with online WSL runtime bootstrap. Windows Node, pnpm
and Git are not required. Internet is required for installation and provider tools.
Paste each applicable block into Windows PowerShell. You can start in any
folder, including C:\Windows\System32; no manual asset download or cd is needed.
The installation block below downloads both release assets itself.
1. Install WSL and Ubuntu, only if missing
Check your existing distributions:
wsl.exe --list --verboseIf Ubuntu is already listed with VERSION 2 and you have created its Linux user,
skip to step 2. Otherwise, open PowerShell as Administrator and run:
wsl.exe --install -d UbuntuRestart Windows if requested. Then, in a normal PowerShell window, run:
wsl.exe --set-version Ubuntu 2
wsl.exe -d UbuntuComplete Ubuntu's first-start username/password prompts. Type exit to return to
PowerShell. Keep this normal PowerShell window for the remaining steps. These are
Microsoft's WSL installation steps.
An existing Ubuntu installation does not need to be removed.
2. Prepare Ubuntu prerequisites
Skip this block if Ubuntu already has standalone Linux Node >=22, pnpm 9.12.3,
systemd user services, bubblewrap and socat. Otherwise paste the block below into
PowerShell. It installs Ubuntu packages, uses the official NodeSource Node 22
repository if Node is missing/older, and installs the pinned Linux pnpm if needed.
It requires Ubuntu root access through WSL and changes packages inside Ubuntu.
& {
$ErrorActionPreference = 'Stop'
function Invoke-UbuntuRoot {
param([string[]]$LinuxArguments)
& wsl.exe -d Ubuntu -u root -- @LinuxArguments
if ($LASTEXITCODE -ne 0) { throw 'Ubuntu prerequisite installation stopped. Resolve the error before continuing.' }
}
function Get-UbuntuVersion {
param([string]$Tool)
try {
$version = & wsl.exe -d Ubuntu -- $Tool --version 2>$null
if ($LASTEXITCODE -eq 0) { return ([string]$version).Trim() }
} catch { }
return ''
}
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'update')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'ca-certificates', 'curl', 'bubblewrap', 'socat', 'systemd', 'systemd-sysv')
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22) {
Invoke-UbuntuRoot -LinuxArguments @('install', '-d', '-m', '700', '/root/.cache/sentry-bootstrap')
Invoke-UbuntuRoot -LinuxArguments @('curl', '-fsSL', 'https://deb.nodesource.com/setup_22.x', '-o', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('bash', '/root/.cache/sentry-bootstrap/node22.sh')
Invoke-UbuntuRoot -LinuxArguments @('apt-get', 'install', '-y', 'nodejs')
}
$pnpmVersion = Get-UbuntuVersion -Tool 'pnpm'
if ($pnpmVersion -cne '9.12.3') {
Invoke-UbuntuRoot -LinuxArguments @('npm', 'install', '--global', 'pnpm@9.12.3')
}
$nodeVersion = Get-UbuntuVersion -Tool 'node'
if ($nodeVersion -notmatch '^v(\d+)\.' -or [int]$Matches[1] -lt 22 -or
(Get-UbuntuVersion -Tool 'pnpm') -cne '9.12.3') {
throw 'Node >=22 or pnpm 9.12.3 is unavailable inside Ubuntu. Installation stopped.'
}
& wsl.exe -d Ubuntu -- systemctl --user show-environment
if ($LASTEXITCODE -ne 0) {
throw 'Ubuntu systemd user services are unavailable. Follow the systemd guidance below, then rerun this block.'
}
Write-Host 'Ubuntu prerequisites installed. Continue with Install Sentry below.'
}Current Ubuntu WSL installations enable systemd by default. If this block reports
that systemd user services are unavailable, stop and follow Microsoft's
systemd guidance, then
rerun the block. Preserve any existing /etc/wsl.conf settings. The application
requires a working systemd user manager; installing packages alone does not enable
it in an older customized distribution.
Node installation follows the official NodeSource instructions.
3. Download, verify and install Sentry
Paste this entire block into your normal PowerShell window. It automatically
downloads the exact v1.0.0 ZIP and checksum into your user Downloads folder,
verifies the pinned checksum, manifest, source identity and distribution files,
then runs setup, installs pinned provider tools and opens Desktop. Any download,
verification or setup failure stops the block before later steps.
The application is installed in
%LOCALAPPDATA%\Sentry\releases\sentry-1.0.0-91dcb102fb5d-windows-x64.
An existing matching installation is verified and reused; existing files are not
overwritten. Close any running Sentry instance before setup.
& {
$ErrorActionPreference = 'Stop'
$name = 'sentry-1.0.0-91dcb102fb5d-windows-x64'
$expectedHash = 'd6729daaaac391988da1016f4f9666d88d01ac77008ac11352cd8b18bd3275b8'
$expectedManifest = '69c68ac32fac1520ffe9b5f01eba9493ba7c31fa2731ed6715b16d9dcd92d883'
$source = '91dcb102fb5dcfd0ab3b6de518814b8305288b0b'
$download = Join-Path $env:USERPROFILE 'Downloads\Sentry-v1.0.0'
$destination = Join-Path $env:LOCALAPPDATA 'Sentry\releases'
$installation = Join-Path $destination $name
$zip = Join-Path $download ($name + '.zip')
$checksum = $zip + '.sha256'
$url = 'https://github.com/Mert1026/Sentry/releases/download/v1.0.0/'
New-Item -ItemType Directory -Path $download, $destination -Force | Out-Null
Write-Host 'Downloading the official ZIP and checksum...'
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip') -OutFile $zip
Invoke-WebRequest -UseBasicParsing -Uri ($url + $name + '.zip.sha256') -OutFile $checksum
if (-not (Test-Path -LiteralPath $zip -PathType Leaf) -or
-not (Test-Path -LiteralPath $checksum -PathType Leaf)) {
throw 'The ZIP or checksum file is missing. Installation stopped.'
}
$sidecarHash = ((Get-Content -LiteralPath $checksum -Raw).Trim() -split '\s+')[0]
$actualHash = (Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash
if ($sidecarHash -notmatch '^[a-fA-F0-9]{64}$' -or
$sidecarHash -ine $expectedHash -or $actualHash -ine $expectedHash) {
throw 'Checksum verification failed. Installation stopped.'
}
if (-not (Test-Path -LiteralPath $installation)) {
Expand-Archive -LiteralPath $zip -DestinationPath $destination
}
$manifestPath = Join-Path $installation 'distribution.json'
if ((Get-FileHash -LiteralPath $manifestPath -Algorithm SHA256).Hash -ine $expectedManifest) {
throw 'Distribution manifest mismatch. Installation stopped.'
}
$manifest = Get-Content -LiteralPath $manifestPath -Raw | ConvertFrom-Json
if ($manifest.sourceCommit -cne $source -or $manifest.version -cne '1.0.0' -or
$manifest.runtimeProtocol -ne 1 -or $manifest.targetPlatform -cne 'windows-x64') {
throw 'Release identity mismatch. Installation stopped.'
}
foreach ($file in $manifest.files.PSObject.Properties) {
$path = Join-Path $installation $file.Name
if ((Get-FileHash -LiteralPath $path -Algorithm SHA256).Hash -ine $file.Value) {
throw ('Distribution file mismatch: ' + $file.Name)
}
}
Write-Host 'Approved checksum, manifest, source identity and files verified.'
$launcher = Join-Path $installation 'sentry.ps1'
foreach ($step in @('version', 'setup', 'tools', 'open')) {
Write-Host ('Sentry: ' + $step)
if ($step -in @('setup', 'tools')) {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step -Distro Ubuntu
} else {
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher $step
}
if ($LASTEXITCODE -ne 0) {
throw ('Sentry ' + $step + ' stopped. Resolve the reported error, then paste this block again.')
}
}
Write-Host ('Installed at: ' + $installation)
Write-Host 'Check Environmen...Sentry v0.1.0-beta.1
Sentry v0.1.0-beta.1
Tagged source: 0e5c10cfa80f6385ebfc88a7306b38ce8a12ce38, merged through
release PR #1. All three configured
CI jobs passed on this exact commit:
main CI 37893841778.
The six sandbox trust tests could not run on the hosted runner; they passed in
the full local WSL suite. This is a draft pre-release for owner review.
First source beta of Sentry, a local-first AI QA application. Three agents
independently investigate one immutable snapshot and return evidence/findings.
This pre-release is for early testers, not production use. Consult the
validation report before distribution.
Supported systems
- Windows 11 with WSL2 (Ubuntu preferred for runtime).
- Native CachyOS with graphical session and systemd user services.
Other native Linux distributions/macOS are unsupported. On 2026-10-09 the owner
confirmed 3/3 success on both hosts and authorized release preparation. This is
owner-reported acceptance, not an independent rerun by the agent. Manual
active-provider cancellation/exit/update and CachyOS maintenance were not
independently verified; automated safety regressions and Windows idle quit pass.
Features
- Desktop project/run workspace, immutable revisions, evidence inspection,
token usage, JSON/log export and native Save As. - Full/Targeted QA: OpenCode 1.18.32, DeepSeek SDK 0.1.5-rc.2, and GLM
through Claude Code 2.1.270; cancellation and persistent history. - Host-specific setup/diagnostics, isolated Linux execution, runtime handshake
and CLI control of the running Desktop. - Provider/model settings and encrypted persistence when OS storage is available.
- Safer maintenance shutdown, awaited Electron cleanup, Linux startup failure
feedback, and private-file exclusions during staging.
Installation
Git, Node >= 22, pnpm 9.12.3, internet, repository access and API accounts/credit
are required. Install the tagged source:
git clone --branch v0.1.0-beta.1 https://github.com/Mert1026/Sentry.git
cd Sentry
Windows: .\sentry.ps1 setup, then sentry open.
CachyOS: ./sentry setup, then ./sentry open in a graphical session.
Configure Settings → Providers, check Environment, add a project and start QA.
See getting started and
CachyOS setup.
Cancel active work and wait before stop/maintenance. Verify Environment and
sentry cli capabilities --json; process survival does not prove readiness.
Updates
Beta tags keep the validated revision pinned. sentry update follows development
origin/main and refuses detached tags. Opting into main can install untested
changes. Later betas need explicit tag checkout/setup; see updating.
Known limitations
- Source installation only; no signed installer, AppImage or tested binary asset.
- Setup can require Windows reboot or CachyOS package installation.
- API credit/provider availability and valid endpoints/models are necessary.
- Sandbox trust tests are unverified where user-unit mounts are unavailable.
Ubuntu CI does not prove native CachyOS acceptance. - Legacy merger/verifier/issue-ingestion components remain for compatibility;
merge/verification ingestion is not exposed through current Desktop RPC. - Active work is not promised to continue after exit. Cancel and wait first;
interrupted work uses existing recovery. Candidate active-run exit acceptance
must be recorded separately. - Private repository: testers need access to code/releases.
Security and privacy
Providers receive relevant prompts/source/evidence; review privacy/pricing before
using confidential code. Sandbox/evidence controls remain. safeStorage uses
Windows DPAPI or the available Linux backend; assess that backend on target.
Unavailable encryption has no plaintext persistence fallback. Review logs and
exports; never share keys, credential stores, databases or retained workspaces.
Feedback
Use GitHub Issues with version/commit,
host OS, WSL distro where relevant, failing command, reproduction, expected/actual
behavior and reviewed status/doctor output. See troubleshooting.