- 01Copy the instructionsNo repository clone needed
- 02Paste into your AI chatUse a client with local command access
- 03AI checks and installsReview requested changes
- 04Finish local setupSet your own PIN and recovery key
RECOMMENDED
Let your AI assistant set it up
Copy and paste this into your conversation. The assistant checks for an existing installation, verifies a release package, installs the local broker, connects MCP, and hands local setup back to you.
Install or reuse SecretBridge on this computer and connect it to the MCP-capable AI client I am using. Product repository: https://github.com/qq940500529/secretbridge. Carry out the deployment and read-only connection check where possible; do not stop at listing instructions. Start from any directory and do not assume the repository is cloned.
1. First check the current client's SecretBridge MCP entry, PATH, and the documented platform-default installation record. Run status with any candidate binary. Reuse a healthy, suitable installation; if its broker is stopped, start it with the active installed binary. Do not install another copy just because this is a new chat or client. Ask me for an unknown custom install location before proceeding.
2. For a new installation, read AGENTS.md, SECURITY.md, and docs/getting-started/AI辅助部署.md, 自动化部署运行手册.md, and 安装与服务管理.md in the repository. Check this computer's OS and architecture. Prefer the latest suitable native GitHub Release, download its .sha256 sidecar, compare the digest, and run verify-package. Build the latest main in a new directory with the documented checks only if no suitable release package exists.
3. Before changing installation directories, system settings, or MCP client configuration, show the target, commands, and necessary backup, then wait for my approval. Version 0.3.1 cannot be installed over older data; retain the old installation and an independent backup, and use a separate empty data directory for evaluation. Stop and diagnose any failed download, verification, build, or install step. Do not skip checks, overwrite old data, or weaken local security settings.
4. Start or reuse the broker and confirm healthy status and a loopback-only console. Use the active binary returned by install or status to run client-config CLIENT. Merge only the SecretBridge entry into this client's format and reload it. Confirm the tools appear, then call the read-only secretbridge_terminal_capabilities tool. If safe configuration is not possible, give me a precise paste-ready fragment and reload steps.
5. After a new installation, inspect install.management_page. If it is opened, do not call open again. If it is manual_open_required and this computer has an interactive desktop, use the active binary's open command to show the local console. I will personally accept the terms, set a PIN/passphrase, save the recovery key, and optionally bind an authenticator in the local page. Do not read, enter, capture, or relay those values or a one-time pairing link.
6. Recheck broker health and the read-only MCP capability, then report whether you reused or installed, the version, verification results, and remaining human steps. Do not inspect existing credential-store entries or expose secrets, personal paths, private hosts, or pairing material in chat, commands, environment variables, logs, or shared reports.Based on the product repository's deployment guide Use the reference below if your AI client cannot run commands locally.
Version 0.3.1 is incompatible with older data. The assistant should reuse a healthy installation; evaluate a new version only with the previous installation and backup preserved in a separate empty data directory.
Manual installation and release files
Already installed? Reuse it
Check your current AI client's SecretBridge MCP entry, the executable on PATH, and the documented default installation record for your platform. Check only these known locations.
Run status with the candidate binary. If its version is suitable and it is healthy, reuse it; if running is false, run start with that installed binary. A new client or conversation does not require another installation.
See default locations and reuse rulesIf needed, choose your platform
Choose a public release package for your operating system and architecture. Use the product repository's GitHub Release; consult the upstream source-build guide if no suitable package exists.
Windows x86_64
secretbridge-0.3.1-windows-x86_64.zip
a6194d1f342d889b64b89592cfc378cfde9d1014cf028eaf11d728da07569f84
Check the digest, verify the package, then install
& {
$ErrorActionPreference = 'Stop'
$expected = 'a6194d1f342d889b64b89592cfc378cfde9d1014cf028eaf11d728da07569f84'
$actual = (Get-FileHash .\secretbridge-0.3.1-windows-x86_64.zip -Algorithm SHA256).Hash
if ($actual -ne $expected) { throw 'SHA-256 mismatch; stop.' }
Expand-Archive .\secretbridge-0.3.1-windows-x86_64.zip -DestinationPath .\secretbridge-package
Set-Location .\secretbridge-package
.\bin\secretbridge.exe verify-package (Get-Location).Path
if ($LASTEXITCODE -ne 0) { throw 'Package verification failed; stop.' }
.\bin\secretbridge.exe install (Get-Location).Path
if ($LASTEXITCODE -ne 0) { throw 'Installation failed.' }
}Linux x86_64
secretbridge-0.3.1-linux-x86_64.tar.gz
e5b46d69245e243c5e5737a12b646af14bceb9f6ca060f470b70078a7d88f2d0
Check the digest, verify the package, then install
(
set -e
printf '%s %s\n' 'e5b46d69245e243c5e5737a12b646af14bceb9f6ca060f470b70078a7d88f2d0' 'secretbridge-0.3.1-linux-x86_64.tar.gz' | sha256sum -c -
mkdir secretbridge-package
tar -xzf secretbridge-0.3.1-linux-x86_64.tar.gz -C secretbridge-package
cd secretbridge-package
./bin/secretbridge verify-package "$PWD"
./bin/secretbridge install "$PWD"
)macOS arm64
secretbridge-0.3.1-macos-aarch64.tar.gz
08761e67343b31e818fe9e12f52228eb80a8b5a6504f7e67c66b744b7e524b2c
Check the digest, verify the package, then install
(
set -e
printf '%s %s\n' '08761e67343b31e818fe9e12f52228eb80a8b5a6504f7e67c66b744b7e524b2c' 'secretbridge-0.3.1-macos-aarch64.tar.gz' | shasum -a 256 -c -
mkdir secretbridge-package
tar -xzf secretbridge-0.3.1-macos-aarch64.tar.gz -C secretbridge-package
cd secretbridge-package
./bin/secretbridge verify-package "$PWD"
./bin/secretbridge install "$PWD"
)Verification materials and earlier releases
Native packages include a manifest, CycloneDX 1.6 SBOM, third-party licenses and corresponding source. Check the GitHub release source, digest and package manifest before installation.
Package verification guide · Earlier releases · Browse corresponding source · Full upstream install guide
Release metadata reviewed 2026-10-12 UTC · This page uses the verified snapshot retained with this build.