Skip to content

Instantly share code, notes, and snippets.

@promer94
Created June 2, 2026 18:30
Show Gist options
  • Select an option

  • Save promer94/40a8b09ebf9a78d02fc7344f5ccaabe6 to your computer and use it in GitHub Desktop.

Select an option

Save promer94/40a8b09ebf9a78d02fc7344f5ccaabe6 to your computer and use it in GitHub Desktop.
AGENTS.md

Global Codex Instructions

Node.js Tooling

Vite+ (vp) is the unified toolchain and entry point for web development. It manages the runtime, package manager, and frontend toolchain in one place. For Node.js and web development, prefer vp commands.

Daily command mapping:

  • Shims node, npm, npx, vpx, vpr
  • Dependencies: use vp install, vp add, vp remove, vp update, vp dedupe, vp outdated, vp list, vp why, vp info, and vp rebuild. Pass install flags through vp install, such as --frozen-lockfile, --lockfile-only, --filter <pattern>, or -w.
  • Vite+ project lifecycle: use vp dev, vp build, vp preview, vp check, vp lint, vp fmt, and vp test. Prefer vp check for static validation loops. Use vp pack for libraries, packages, and CLIs.
  • Ordinary Node.js project scripts: use vp run <script> or vpr <script> instead of npm run / pnpm run. If a script name conflicts with a built-in command, such as test or build, vp run <script> runs the package script.
  • Monorepo tasks: vp run runs in the current package by default; use vp run <package>#<task>, vp run -r <task>, vp run -t <package>#<task>, vp run --filter <pattern> <task>, or vp run -w <task> for workspace execution.
  • Local binaries: use vp exec <binary> ... or vpx <binary> ... for node_modules/.bin.
  • Node scripts and snippets: use the shimmed node ... or vp node ....
  • One-off package binaries: use vp dlx ....
  • Project setup: use vp create, vp migrate, vp config, and vp staged for scaffolding, migration, hooks, and staged-file checks.
  • Raw package-manager behavior is an escape hatch: use vp pm <command> only when the normalized vp commands do not cover the need.
  • Environment debugging: use vp env current, vp env doctor, and vp env which <tool> to inspect runtime and shim resolution.

Avoid pnpm exec vp ..., npm exec vp ..., raw pnpm/npm/yarn/bun install, and vp run node/tsc/vite-node. vp run is for tasks; use node, vp node, vp exec, or vpx for commands and binaries.

Python Tooling

For Python-related work, prefer using uv when applicable instead of calling Python, pip, venv, or package-management commands directly.

Common examples:

  • Use uv run <command> for running Python commands or project scripts.
  • Use uv sync for installing project dependencies from lockfiles.
  • Use uv add and uv remove for dependency changes.
  • Use uvx <tool> or uv tool run <tool> for one-off Python tools.
  • Use uv python ... for Python version management.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment