The Universal Polyglot CLI Package & Dependency Orchestrator
One consistent syntax to add, remove, and synchronize dependencies across Node.js, Python, Rust, and Go.
Official Web Platform & Interactive Simulator: https://ritualdev.in/poly
Official VS Code Extension: RitualDev-Lab/vscode-poly
Official GitHub Action: RitualDev-Lab/setup-poly
Enterprise Web Repository: RitualDev-Lab/poly-web
Modern engineering teams rarely build in a single programming language. A typical stack often pairs a Next.js frontend, a Python AI backend, and Rust/Go microservices or WebAssembly crates.
Switching cognitive context between pnpm add, uv add, cargo add, and go get creates friction and trips up autonomous AI coding agents (Claude Code, Cursor, Windsurf).
poly acts as a zero-latency orchestrator that translates universal package requests into the fastest native package manager on your system.
┌─────────────────────────────┐
│ poly CLI Runner │
│ (Zero-Runtime Overhead) │
└──────────────┬──────────────┘
│
┌──────────────────────────┼──────────────────────────┐
▼ ▼ ▼
┌──────────────────────┐ ┌──────────────────────┐ ┌──────────────────────┐
│ Node.js (npm) │ │ Python (PyPI) │ │ Rust (Cargo) │
│ pnpm · bun · npm │ │ uv · pip │ │ cargo │
└──────────────────────┘ └──────────────────────┘ └──────────────────────┘
- PURL Standard & Shorthand: Use
npm:zod,pypi:fastapi,cargo:tokio, or standardpkg:npm/...specifications. - Polyglot Workspaces (
poly.toml): Orchestrate monorepos with parallel dependency synchronization across members. - Composite Cryptographic Lockfile (
poly.lock): High-speed SHA-256 integrity verification tracking all underlying native lockfiles. - Zero-Drift CI/CD Mode (
--frozen): Deterministically fails if any manifest or lockfile is modified out-of-band. - Cross-Stack Task Runner (
poly run <task>): Concurrently run scripts across services with colorized prefix streaming. - Native Engine Delegation: Zero custom solvers or lockfile corruption.
polydelegates 100% of the resolution to verified native tools (uv,pnpm,cargo,go). - Interactive Disambiguation: When multiple manifests exist in the same directory,
polypresents an inline selection prompt. - AI Agent Friendly: Eliminates shell syntax hallucination for autonomous coding agents.
# Global install via npm
npm install -g @ritualdev-lab/poly
# Or run instantly via npx
npx @ritualdev-lab/poly add pypi:fastapiUse the official setup-poly action in your workflow:
- name: Set up Poly
uses: RitualDev-Lab/setup-poly@v1
with:
version: 'latest'
- name: Sync dependencies & verify zero drift
run: poly install --frozen
- name: Cross-stack CVE security gate
run: poly audit --fail-on high# Explicit ecosystem shorthand
poly add npm:zod
poly add pypi:fastapi
poly add cargo:tokio --features full
poly add go:github.com/gin-gonic/gin
# Adding development dependencies
poly add npm:vitest -D
poly add pypi:pytest -D
# Auto-detect ecosystem from current working directory
cd services/api
poly add requests # Automatically routes to PyPI via uv or pippoly remove npm:lodash
poly remove pypi:scikit-learn# Sync dependencies for closest project
poly install
# Synchronize all polyglot projects across an entire monorepo
poly install --all
# Upgrade specific package to latest compatible version
poly update npm:zod
poly update pypi:fastapi
# Upgrade all dependencies across all ecosystems
poly update# Synchronize all workspace members concurrently
poly sync
# Enforce zero-drift in CI/CD pipelines (fails if lockfile is out of sync)
poly install --frozen
# Verify composite lockfile cryptographic integrity without modifying disk
poly lock --verify
# Run cross-stack scripts across services with colorized prefix streaming
poly run dev
poly run test --filter apps/web# Query OSV database for known vulnerabilities across all ecosystems
poly audit
# Automatically remediate vulnerabilities and patch manifests
poly fix
# Dry-run remediation without modifying files on disk
poly fix --dry-run
# Enforce security gates in CI/CD (fails build if HIGH or CRITICAL CVEs exist)
poly audit --fail-on high
# Export standard SARIF v2.1.0 report for GitHub Advanced Security
poly audit --format sarif --output poly-security.sarif
# Audit license compliance & flag forbidden copyleft licenses (GPL/AGPL)
poly license --check
# Generate CycloneDX v1.5 or SPDX v2.3 Software Bill of Materials (SBOM)
poly sbom --format cyclonedx --output sbom.json
poly sbom --format spdx --output spdx.json# Run complete diagnostic suite (Node, Python, Rust, Go, C compiler, registries, drift)
poly doctor
# Machine-readable diagnostic report for CI or agent pipelines
poly doctor --json# Generate production multi-stage Dockerfile and docker-compose.yml
poly docker
# Generate with VS Code / GitHub Codespaces DevContainer configuration
poly docker --devcontainer
# Preview generated container artifacts without writing to disk
poly docker --devcontainer --dry-run
# Output artifacts to custom target directory
poly docker --output-dir ./deploy/docker# Generate Ed25519 cryptographic signing keypair (PEM format)
poly attest keygen
# Generate in-toto SLSA Provenance v1.0 statement
poly attest generate --output attestation.json
# Cryptographically sign provenance statement into DSSE envelope
poly attest sign --key poly-key.pem --output signed-envelope.json
# Verify DSSE envelope signature & enforce zero artifact drift on disk
poly attest verify --attestation signed-envelope.json --key poly-key.pub
# Evaluate enterprise license whitelists and CVE thresholds
poly policy --fail-on-violation# Save dependency artifacts (node_modules, .venv, target) into local / CI cache
poly cache save
# Restore dependency artifacts using deterministic OS/Arch/poly.lock hash key
poly cache restore
# Purge local cache
poly cache clean
# Verify reachability and latency of corporate registries (Artifactory, Nexus, AWS CodeArtifact)
poly registry testBridge directly into your hosted poly-cloud-api server:
# Authenticate against your hosted Poly Cloud API server (stores in ~/.poly/config.json)
poly login --url https://cache.ritualdev.in --token poly_tok_abc123 --workspace default
# Display active authenticated session
poly whoami
# Inspect live cluster latency, hit rate (%), saved compute time, and dollar ROI
poly cache status
poly cache status --json
# Invalidate remote cache for the current git branch with one command
poly cache purge
poly cache purge --branch feature/login-flow
poly cache purge --all
# Log out and remove local stored credentials
poly logout# Start the stdio Model Context Protocol (MCP) server for AI coding agents
poly mcp
# Output ready-to-paste MCP client configuration for Cursor or Claude Desktop
poly mcp --config
# Automatically configure IDE extensions and AI rules (.cursor/mcp.json, .cursor/rules/poly.mdc)
poly init --ide cursor
poly init --ide claude
poly init --ide all
# Machine-readable output mode across commands
poly which npm --json
poly lock --verify --jsonpoly which npm # e.g., pnpm (v9.15.4)
poly which pypi # e.g., uv (v0.5.1)
poly which cargo # e.g., cargo (v1.84.0)MIT © RitualDev Lab
If you find this project valuable, consider supporting our open-source development: