jacopobonomi/venv_manager
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
개발자와 AI 코딩 에이전트를 위한 안전하고, 관찰 가능하고 역동적인 Python 환경. CLI, TUI 및 MCP 서버 하나에서 이동 바이너리.
개요
개발자를 위한 1개의 Python 환경 통제 층. Go. 1개의 정적 이진, python3 (또는 uv, 유효한 경우에) 저런타임 deps. 위 GIF는 실제: venv-manager watch app.py --venv X는 파일을 모니터링하고, 작은 AST-lite 파서로 가져 오기를 스캔하고, 모든 파일 변경이 누락됩니다. 스크립트에서 LLM을 실행하고 코드로 venv의 융합입니다. Claude, Codex, Cursor 및 기타 코딩 에이전트는 이미 쉘 명령을 실행하고 .venv를 만들고 민감한 작업 전에 승인을 요청합니다. 그들이 공유하지 않는 것은 튼튼한 Python 환경 상태입니다. Sandboxing는 기계를 보호합니다. venv-manager는 보호합니다: 그것은 각 대리인에게 동일한 환경, 메타데이터, 포장 역사 및 회복 경로, 실행될 클라이언트의 독립을 줍니다. 1. 명세.
개요(AI 번역)
개발자용 One Python 환경 제어 레이어 ** 및 모든 AI 코딩 에이전트**.
Go. 1개의 정적 이진, python3]를 넘어서는 runtime deps (또는 uv).
위의 GIF는 실제: venv-manager watch app.py --venv X] 파일을 모니터링하고, 작은 AST-lite 파서로 가져 오기를 스캔하고, 모든 파일 변경이 누락됩니다. 스크립트에서 LLM을 실행하고 코드로 venv의 융합입니다.
왜
Claude, Codex, Cursor 및 기타 코딩 에이전트는 이미 쉘 명령을 실행하고 .venv]을 만들고 민감한 작업 전에 승인을 요청합니다. 그들이 공유하지 않는 것은 튼튼한 Python 환경 상태입니다.
Sandboxing는 기계를 보호합니다. venv-manager는 ** 워크 플로우를 보호합니다 ** : 그것은 모든 에이전트에게 동일한 환경, 메타 데이터, 패키지 역사 및 복구 경로, 독립적으로 실행되는 클라이언트의.
2개의 실패 형태는 이 공구를 몹니다:
- ** 인간 sprawl.**
~]에서 곱한 Venvs는, 캐시 디렉토리는 GB를 먹는다, 활성화 구문은 포탄에 의해 변화하고, “일한 env”는 맨끝 사이 복사 투표pip freeze를 의미합니다. - ** 긴급한 sprawl.
이 페이지는 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"]
}
}
}