README проекта с github.com/notinferred/keypaste. Одним файлом markdown: README.md.
Your centralized access manager: passwords, keys and project environments on your computer, and AI agents get a secret only when you say yes.
keypaste keeps your logins, API keys and project values in a KeePass (KDBX) file on your computer, with no account, and KeePassXC opens the same file. An AI tool such as Claude Code asks keypaste for one field at a time, nothing is released without your answer or a rule you set, and every request is logged. keypaste is the keypaste command-line tool, the MCP bridge that connects AI tools, and the desktop app.
Available now in v0.3.0, the command-line tool and MCP bridge for macOS, Linux and Windows:
.env files. keypaste run hands a project's values to a command through its environment and writes nothing to disk.keypaste setup connects Claude Code and Codex, and prints the configuration for Cursor and Claude Desktop.Coming in 1.0, the next public release, which adds the desktop app for Windows, macOS and Linux. It is implemented and not yet published:
.env.keypaste reference files can be committed.FEATURES gives each capability's state. Planned after 1.0 and not built yet: agents that use credentials they never hold, your own end-to-end-encrypted cloud vault, team projects, then organizations with work vaults the company owns and hands over when someone leaves.
![]() |
![]() |
1.0 preview: a vault's items, and an agent's request.
These blocks install v0.3.0, the command-line tool and the MCP bridge, from https://dl.keypaste.com/v0.3.0/. Each downloads the archive and its checksum, checks the hash, and extracts two native binaries, keypaste and keypaste-mcp, which need no .NET runtime. On macOS and Linux they go into ~/.local/bin; command -v keypaste checks that it is on your PATH.
curl -fLO https://dl.keypaste.com/v0.3.0/keypaste-0.3.0-osx-arm64.tar.gz
curl -fLO https://dl.keypaste.com/v0.3.0/keypaste-0.3.0-osx-arm64.tar.gz.sha256
shasum -a 256 -c keypaste-0.3.0-osx-arm64.tar.gz.sha256
tar -xzf keypaste-0.3.0-osx-arm64.tar.gz
mkdir -p ~/.local/bin && mv keypaste keypaste-mcp ~/.local/bin/
macOS 14 or later. This floor follows .NET 10 support; no run backs this floor. Intel Macs have no published binary and need a source build. If macOS blocks the unsigned binary, xattr -d com.apple.quarantine ~/.local/bin/keypaste removes the quarantine attribute; the command-line download above should not set it.
curl -fLO https://dl.keypaste.com/v0.3.0/keypaste-0.3.0-linux-x64.tar.gz
curl -fLO https://dl.keypaste.com/v0.3.0/keypaste-0.3.0-linux-x64.tar.gz.sha256
sha256sum -c keypaste-0.3.0-linux-x64.tar.gz.sha256
tar -xzf keypaste-0.3.0-linux-x64.tar.gz
mkdir -p ~/.local/bin && mv keypaste keypaste-mcp ~/.local/bin/
For arm64, substitute linux-arm64 in all three filenames. Both are built against glibc 2.35. The release workflow checks the x64 binary on a clean Debian 12 container and checks that it fails on Alpine; the equivalent container check is not implemented for arm64. Alpine and other musl distributions have no published binary; build from source there.
$a = "keypaste-0.3.0-win-x64.zip"
Invoke-WebRequest -OutFile $a "https://dl.keypaste.com/v0.3.0/$a"
Invoke-WebRequest -OutFile "$a.sha256" "https://dl.keypaste.com/v0.3.0/$a.sha256"
$want = (Get-Content "$a.sha256" -Raw).Split()[0]
if ((Get-FileHash $a -Algorithm SHA256).Hash -ne $want) { throw "checksum mismatch" }
Expand-Archive $a -DestinationPath .
Windows 10 1809 or later. This floor follows .NET 10 support; no run backs this floor. Put the extracted binaries in a directory on your PATH.
The checksum catches a corrupted or incomplete download; it cannot prove who published the archive, because it is served from the same origin. The binaries are unsigned and un-notarized, and every v0.3.0 asset carries a build attestation that GitHub CLI checks without an account: SECURITY gives the steps and THREATS T-21 the trust boundary. If you still run v0.1.0 or v0.2.0, replace it; SECURITY lists their defects.
With v0.3.0 installed:
# 1. Create a vault
keypaste init ~/vault.kdbx
export KEYPASTE_VAULT=~/vault.kdbx
# 2. Add a login, and a value to a project
keypaste add github --username me --url https://github.com
keypaste env set myapp STRIPE_KEY
# 3. Run a command with the project's values in its environment
keypaste run myapp -- npm start
# 4. Connect your AI tools, then answer their requests in this terminal
keypaste setup --vault ~/vault.kdbx
keypaste agent --vault ~/vault.kdbx
keypaste get github copies the password and clears the clipboard after twenty seconds, --generate on add or env set makes the value for you, and keypaste env pull myapp imports an existing .env into the project. The guides describe 1.0, which renames a few commands: keypaste agent becomes keypaste approve, the bridge becomes keypaste mcp, and get --show becomes get --reveal (every rename).
| exit code | meaning |
|---|---|
| 0 | success |
| 1 | usage error |
| 2 | internal or environment error (including no usable clipboard, and an item name two items answer to) |
| 3 | vault or item not found |
| 4 | wrong master password |
| 5 | the audit log is not the file keypaste wrote |
Data goes to stdout and diagnostics to stderr, and --vault works in place of KEYPASTE_VAULT. When stdin is not a terminal, each prompt reads one line in order: init takes the new password twice, and add and env set take the master password and then a value unless generating one.
When an agent asks, the approver shows who is asking, for what and why, and waits for your answer. This is the 1.0 terminal prompt of keypaste approve; v0.3.0's keypaste agent asks Approve? [y/N] instead.
────────────────────────────────────────────────────────────
keypaste: an agent is asking for a credential.
agent claude-code (claude-code)
item .env
group env/demo
field STRIPE_KEY
the agent says it needs this because:
deploy the billing service to staging
That sentence was written by the agent, not by keypaste. Treat it as a claim.
[d] deny [o] once [a] always 45s ›
keypaste log reads every request back from the local log:
3 records in /home/you/.keypaste/audit.jsonl
time (UTC) agent item decision method
2026-07-26 14:03:09 claude-code - granted exposure
2026-07-26 14:03:11 claude-code env/demo/.env granted prompt
2026-07-26 14:07:44 claude-code env/demo/.env denied prompt
The guides describe the 1.0 build, and each says what v0.3.0 lacks.
.env: projects, stages, keypaste run, CI and export.keypaste setup, manual configuration and what an agent can see.Building from source lets you inspect the code you run, and it is the only route on Intel Macs, musl distributions such as Alpine, and Windows on ARM. With the .NET SDK pinned in global.json:
git clone --recurse-submodules https://github.com/notinferred/keypaste
cd keypaste
dotnet build keypaste.slnx -c Release
keypaste lands in artifacts/bin/Keypaste.Cli/release/ (.exe on Windows) and, built this way, is also the bridge as keypaste mcp. The vault is KDBX 4 with AES-256 and Argon2d, written through KeePassLib vendored from KeePass 2.61; keypaste writes no cryptography of its own.
Bugs, missing features and anything that made no sense to you go to the issue tracker: say what you ran, what you expected and what happened. Report anything that looks like a security problem privately to [email protected], not the tracker; SECURITY owns scope, process and timing.
AGPL-3.0. Auditable code is how keypaste earns trust.