Discover and manage development environments across Python and JavaScript.

Python

Find scattered .venv directories, Python caches, build artifacts, and more.

uvx envoic scan ~/projects

Artifact scanning is enabled by default for Python scans. Use --no-artifacts to report only environments, or --show-artifacts to expand the artifact summary into detailed rows:

uvx envoic scan ~/projects --show-artifacts
uvx envoic scan ~/projects --no-artifacts

--show-artifacts needs artifact detection enabled, so combining it with --no-artifacts is rejected with an error.

Python package →

JavaScript

Find node_modules, build caches, and JavaScript artifacts.

npx envoic scan ~/projects

JavaScript package →

Install

No install needed:

uvx envoic scan .
npx envoic scan .

Install permanently:

uv tool install envoic      # Python
npm install -g envoic       # JavaScript

Agent Skill

envoic is available as an Agent Skill for coding agents:

Tool	Auto-detected file	Notes
Cursor	.cursor/rules/envoic.mdc	Primary format (generated from skills/envoic/templates/cursor-rule-envoic.mdc)
Cursor (legacy)	.cursorrules	Compatibility fallback
GitHub Copilot	.github/copilot-instructions.md	Generated from skills/envoic/templates/copilot-instructions.md
GitHub Copilot (scoped)	.github/instructions/envoic.instructions.md	Path-scoped instruction file
OpenAI Codex	.agents/skills/envoic/SKILL.md	Symlink/copy of canonical skill
Claude Code	.claude-plugin/plugin.json + .claude-plugin/marketplace.json	Marketplace metadata + plugin manifest

Install from marketplace in Claude Code:

/plugin marketplace add mahimailabs/envoic

Canonical skill source:

skills/envoic/
  SKILL.md
  agents/openai.yaml
  references/
  templates/

Sync generated adapter files after skill updates:

python3 scripts/sync-agent-instructions.py

Set an explicit release version when needed:

python3 scripts/sync-agent-instructions.py --version 0.1.0

If your environment does not support symlinks, copy skills/envoic/ into .agents/skills/envoic/.

Validate skill metadata and adapter drift:

python3 scripts/validate-skill.py
python3 scripts/sync-agent-instructions.py --check

Docs

• Site: https://mahimailabs.github.io/envoic/
• Contributing: CONTRIBUTING.md
• Code of Conduct: CODE_OF_CONDUCT.md

License

MIT