Discover and manage development environments across Python and JavaScript.
Python
Find scattered .venv directories, Python caches, build artifacts, and more.
uvx envoic scan ~/projectsArtifact 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.
JavaScript
Find node_modules, build caches, and JavaScript artifacts.
npx envoic scan ~/projectsInstall
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