keypaste README

README проекта с github.com/notinferred/keypaste. Одним файлом markdown: README.md.

keypaste

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.

What it does

Available now in v0.3.0, the command-line tool and MCP bridge for macOS, Linux and Windows:

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:

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.

The keypaste desktop app: the sidebar's places, the list of items, and the open github login with its username, masked password, website, custom fields and project tag. A request: claude-code, verified, asks for STRIPE_SECRET_KEY from the Stripe test key item, with its reason quoted and the choices Deny, Always allow and Allow once.

1.0 preview: a vault's items, and an agent's request.

Install

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.

macOS, Apple Silicon
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.

Linux, x64 and arm64
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.

Windows, x64
$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.

Quick start

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 codes and scripting
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.

An agent's request

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

Learn more

The guides describe the 1.0 build, and each says what v0.3.0 lacks.

Building from source

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.

Found something wrong?

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.

License

AGPL-3.0. Auditable code is how keypaste earns trust.

keypaste (notinferred/keypaste)

Ищем в базе…

Что это?keypaste — менеджер паролей и секретов, совместимый с KeePass, созданный для тех, кто работает с ИИ-агентами: он хранит логины и секреты проектов в одном локальном хранилище и передаёт секрет агенту только после вашего явного разрешения.
Это CLI, MCP-сервер или настольное приложение?Сейчас оно выходит как CLI и MCP-мост (keypaste-mcp), который пересылает запросы агентов, не храня само хранилище; полноценное настольное приложение есть в исходном коде, но публичного релиза пока нет.
Как установить и настроить?Скачайте архив релиза и контрольную сумму для вашей ОС, проверьте хеш, распакуйте архив и добавьте бинарные файлы в PATH; затем запустите команду настройки, чтобы подключить его к вашему MCP-клиенту (или соберите из исходников с закреплённым .NET SDK).
Нужны ли KeePassXC или среда выполнения .NET, чтобы им пользоваться?Для готовых бинарных файлов среда выполнения не нужна, так как это нативные исполняемые файлы; KeePassXC нужен только если хотите открывать или редактировать то же хранилище в другом приложении, а .NET SDK требуется только при сборке из исходников.
Что стоит знать, прежде чем на него полагаться?Версия до 1.0 (CLI/MCP v0.3.0), и несколько функций из README — настольное приложение, генератор парольных фраз, ссылки для общего доступа и безопасное удаление через корзину — пока есть только в исходниках для следующего релиза. Опубликованные старые версии (v0.1.0, v0.2.0) содержали реальные ошибки при одновременных сохранениях и при удалении не той записи; они исправлены только в будущих версиях.
Какие платформы сейчас поддерживаются?Готовые бинарные файлы есть для macOS 14+ на Apple Silicon, Linux x64/arm64 (glibc) и Windows 10 1809+ x64; для Intel Mac, Alpine/musl Linux и Windows on ARM готового файла нет, и нужно собирать из исходников.
Где на самом деле хранятся данные моего хранилища?Всё находится в одном файле KDBX 4 на вашем собственном диске, без учётной записи и без участия сети; секреты покидают хранилище только когда вы одобряете конкретный запрос агента.
Как ИИ-агент вообще получает секрет?Агент через MCP запрашивает одно конкретное поле одной записи и указывает причину; вы отвечаете «Отказать», «Разрешить один раз» или «Разрешить на 1 час», а каждый запрос записывается в журнал аудита с цепочкой хешей.
Могут ли агенты запускать команды оболочки с моими секретами?Только в режиме inject-only: keypaste run передаёт значения в окружение команды (ничего не попадает на диск), а с --allow-run агент может запустить команду, которую вы одобрили, и получить её вывод с замаскированными значениями секретов.
Как организованы переменные окружения проекта?У каждого проекта есть один набор ключей с отдельными значениями для dev, staging и prod (для prod всегда нужно подтверждение в реальном времени), а файл .env.keypaste, который можно хранить в репозитории, содержит ссылки kp:// вместо реальных значений.
Что предлагает встроенный генератор паролей?Он создаёт пароли, безопасные для командной оболочки, длиной от 8 до 256 символов из алфавита в 85 символов, с возможностью исключить символы или похожие друг на друга символы; режим парольных фраз (--words, список слов EFF) написан в исходниках, но ещё не вошёл в опубликованный релиз.
Какие есть похожие проекты?infisical, PaperPilot, pdfcraft, ente, keepassxc, leviathan, server, xerj
Автор
notinferred
Размер
21.9 MB
Звёзды
448
Обновлён
КоммитNov 18
Возраст
2 мес
Коммиты · 90 дней