jacopobonomi/venv_manager
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
開発者やAI コーディングエージェント向けの、安全、保守可能でリバーシブルな Python 環境。 CLI、TUI、MCP サーバを 1 つで起動します.
概要
開発者のための1つのPython環境制御レイヤー。 Go で書かれています。1つの静的なバイナリ、python3 (または利用可能な場合の uv) を超えるランタイムデプスはありません。 上記のGIFは本物です:venv-manager watch app.py --venv X はファイルを監視し、インポートを小さな AST lite パーサでスキャンし、ファイルが変更されるたびに pip-installs を実行します。 LLM が反復しているスクリプトで、コードとして venv のコンバージを指す。 Claude、Codex、Cursor、その他のコーディングエージェントは、すでにシェルコマンドを実行し、.venvを作成し、機密操作の前に承認を求めることができます。 共有しないのは、耐久性のあるPython環境状態です。 サンドボックスは機械を保護します。 venv-manager は : それは実行されるクライアントの独立した同じ環境、メタデータ、パッケージの履歴および回復パスを、すべてのエージェントに与えます。 1.
概要（AI 翻訳）
開発者のための1つのPython環境制御レイヤーとすべてのAIコーディングエージェント。
python3を超えた1つの静的バイナリ、ランタイムの重複(またはuv)で書かれている。
上記のGIFは本物です。venv-manager watch app.py --venv Xはファイルを監視し、インポートを小さなASTライトパーサでスキャンし、ファイルが変更されるたびに、欠落しているもののip-installsです。 LLM が反復しているスクリプトで、コードとして venv のコンバージを指す。
お問い合わせ
なぜ
Claude、Codex、Cursor、その他のコーディングエージェントは、既にシェルコマンドを実行し、[.venvを作成して、機密操作の前に承認を求めることができます。 共有しないのは、耐久性のあるPython環境状態です。
Sandboxing はマシンを保護します。 [venv-manager]] は、workflow を保護します。これにより、すべてのエージェントに同じ環境、メタデータ、パッケージの履歴、および復元パスが実行されるクライアントとは独立しています。
2 つの失敗モードはこの用具を運転しました:
1.ヒトスプロール。 Venvs は [~]] を重ね、 キャッシュディレクトリは GB を食べ、 アクティベーション・シンタックスはシェルによって異なり、「機能する env」は、ターミナル間のコピー・パスティング pip freezeを意味します。
2。 **エージェントスプロール.
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
venv-manager
One Python environment control layer for developers and every AI coding agent.
Written in Go. One static binary, no runtime deps beyond python3 (or uv, if available).
The GIF above is real: venv-manager watch app.py --venv X monitors a file, scans its imports with a tiny AST-lite parser, and pip-installs whatever is missing — every time the file changes. Point it at a script an LLM is iterating on and the venv converges as the code does.
Why
Claude, Codex, Cursor and other coding agents can already run shell commands, create a .venv, and ask for approval before sensitive operations. What they do not share is durable Python environment state.
Sandboxing protects the machine. venv-manager protects the workflow: it gives every agent the same environments, metadata, package history and recovery path, independent of the client that happens to be running.
Two failure modes drove this tool:
- Human sprawl. Venvs multiply across
~, cache directories eat GB, activation syntax varies by shell, and cloning “the env that worked” means copy-pastingpip freezebetween terminals. - Agent sprawl. AI agents can install into the wrong interpreter, leave partial changes behind, and lose environment context when you switch client or start a new session.
venv-manager solves (1) with a clean CLI and (2) with a shared Model Context Protocol server, a persistent registry, typed snapshots and diffs, reversible package changes, ephemeral venvs with OS-level sandboxing, and a file watcher that keeps a venv in sync with evolving code.
What the agent sandbox does not solve
| Agent capability | Shared environment control |
|---|---|
| Approves or blocks a shell command | Records which environment belongs to which project |
| Restricts filesystem and network access | Preserves state across Claude, Codex and other clients |
| Creates a venv when prompted | Tracks creation and real last-use metadata |
Runs pip, Poetry or uv |
Shows package-level changes between snapshots |
インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →設定
{
"mcpServers": {
"venv-manager": {
"command": "venv-manager",
"args": ["mcp", "--policy", "safe"]
}
}
}