Command Preference & Package Governance System

AI Agent Harness for Preferred Tooling Governance

This repository provides a unified system for AI agents to stay within preferred tooling boundaries while maintaining developer productivity. It serves as a harness for automated systems to enforce tooling policies without breaking existing workflows.

🎯 Purpose

Primary: AI Agent Governance

Enforce tooling preferences for AI agents and automated systems
Prevent tool drift in automated code generation and management
Provide clear guidance when agents attempt to use disfavored tools
Maintain consistency across AI-assisted development workflows

Secondary: Developer Tool Governance

Gradual migration support for teams adopting new tooling standards
Multi-project environments where different projects use different tools
Policy enforcement for organizations with specific tooling requirements
Educational guidance for developers learning new tooling ecosystems

🚀 Quick Start

RTK Token Optimization Wrappers

Install individual RTK wrapper:

# Via Nix
nix profile install .#rtk-wrap-ls

# Via Devbox
devbox add github:levonk/levonk-packages#rtk-wrap-ls

# Install complete RTK suite
nix profile install .#bundle-rtk-all
devbox add github:levonk/levonk-packages#bundle-rtk-all

Usage:

# Commands automatically run through RTK for token optimization
ls -la          # → rtk ls -la (compact output)
git status      # → rtk git status (compact output)
npm install     # → rtk npm install (filtered output)

Devbox Auto-Environment Management

Install devbox-auto wrapper:

# Via Nix
nix profile install .#devbox-auto-npm

# Via Devbox
devbox add github:levonk/levonk-packages#devbox-auto-npm

# Install complete devbox-auto suite
nix profile install .#bundle-devbox-auto-all
devbox add github:levonk/levonk-packages#bundle-devbox-auto-all

Usage:

# Commands automatically ensure tools via devbox
npm install     # → Adds npm to devbox.json → devbox run -- npm install
python script.py  # → Adds python to devbox.json → devbox run -- python script.py

Integrated Devbox-RTK-Governance Packages

Install integrated package (environment + optimization + governance):

# Via Nix
nix profile install .#devbox-rtk-nodejs-pnpm-force

# Via Devbox
devbox add github:levonk/levonk-packages#devbox-rtk-nodejs-pnpm-force

Usage:

# npm → pnpm (force) + devbox environment + RTK optimization
npm install
# → ✅ Using pnpm instead of npm (forced by policy)...
# → 📦 Adding pnpm to devbox environment...
# → devbox run -- rtk pnpm install

Traditional Governance Packages

Note: Nix/Devbox packages work immediately. Other package managers require running just generate first.

With Devbox (Recommended)

# Add npm governance
devbox add github:levonk/levonk-packages#prefer-pnpm

# Add comprehensive governance
devbox add github:levonk/levonk-packages#command-governance

# Your existing workflow continues unchanged
npm install  # Now governed by pnpm

With Nix

# Build locally from source
nix build .#prefer-pnpm
nix build .#command-governance

# Run governed commands
nix run .#prefer-pnpm -- --version

# Install to profile
nix profile install .#prefer-pnpm
nix profile install .#command-governance

Other Package Managers

# First generate packages
git clone https://github.com/levonk/levonk-packages.git
cd levonk-packages
just generate

# Then install via your preferred package manager
# Example for Alpine:
apk add command-prefer-pnpm

📦 Available Packages

RTK Token Optimization Wrappers (54 packages)

Core Commands: rtk-wrap-ls, rtk-wrap-tree, rtk-wrap-cat, rtk-wrap-find, rtk-wrap-grep, rtk-wrap-diff, rtk-wrap-wc, rtk-wrap-curl, rtk-wrap-json, rtk-wrap-env, rtk-wrap-deps, rtk-wrap-test, rtk-wrap-err
Development Tools: rtk-wrap-git, rtk-wrap-npm, rtk-wrap-npx, rtk-wrap-pnpm, rtk-wrap-tsc, rtk-wrap-jest, rtk-wrap-vitest, rtk-wrap-pytest, rtk-wrap-mypy, rtk-wrap-ruff, rtk-wrap-prettier, rtk-wrap-eslint, rtk-wrap-prisma, rtk-wrap-next, rtk-wrap-lint, rtk-wrap-format, rtk-wrap-playwright, rtk-wrap-cargo, rtk-wrap-pip, rtk-wrap-go, rtk-wrap-golangci-lint, rtk-wrap-rubocop, rtk-wrap-rake, rtk-wrap-rspec, rtk-wrap-gradlew
Cloud & DevOps: rtk-wrap-gh, rtk-wrap-glab, rtk-wrap-docker, rtk-wrap-kubectl, rtk-wrap-oc, rtk-wrap-aws, rtk-wrap-psql, rtk-wrap-dotnet, rtk-wrap-wget, rtk-wrap-gt

Bundle Packages:

bundle-rtk-core - Core command wrappers
bundle-rtk-development - Development tool wrappers
bundle-rtk-cloud - Cloud tool wrappers
bundle-rtk-all - All 54 RTK wrapper packages

Devbox Auto-Environment Management (8 packages)

Node.js: devbox-auto-npm, devbox-auto-pnpm, devbox-auto-yarn
Python: devbox-auto-python, devbox-auto-pip
Rust: devbox-auto-cargo, devbox-auto-rustc
Go: devbox-auto-go

Bundle Packages:

bundle-devbox-auto-nodejs - Node.js package managers
bundle-devbox-auto-python - Python tools
bundle-devbox-auto-rust - Rust toolchain
bundle-devbox-auto-go - Go tools
bundle-devbox-auto-all - All devbox-auto wrappers

Integrated Devbox-RTK-Governance Packages (16 packages)

Node.js with pnpm: devbox-rtk-nodejs-pnpm-prefer, devbox-rtk-nodejs-pnpm-force, devbox-rtk-nodejs-pnpm-block, devbox-rtk-nodejs-pnpm-native
Node.js with yarn: devbox-rtk-nodejs-yarn-prefer, devbox-rtk-nodejs-yarn-force, devbox-rtk-nodejs-yarn-block, devbox-rtk-nodejs-yarn-native
Node.js with bun: devbox-rtk-nodejs-bun-prefer, devbox-rtk-nodejs-bun-force, devbox-rtk-nodejs-bun-block, devbox-rtk-nodejs-bun-native
Python with uv: devbox-rtk-python-uv-prefer, devbox-rtk-python-uv-force, devbox-rtk-python-uv-block, devbox-rtk-python-uv-native

npm Governance (12 packages)

npm → pnpm: prefer-pnpm, eject-npm, force-pnpm, block-npm
npm → yarn: prefer-yarn, eject-yarn, force-yarn, block-yarn
npm → bun: prefer-bun, eject-bun, force-bun, block-bun

pnpm Governance (15 packages)

pnpm → npm: prefer-npm, eject-pnpm, force-npm, block-pnpm
pnpm → yarn: prefer-yarn-from-pnpm, eject-yarn-from-pnpm, force-yarn-from-pnpm, block-yarn-from-pnpm
pnpm → bun: prefer-bun-from-pnpm, eject-bun-from-pnpm, force-bun-from-pnpm, block-bun-from-pnpm

yarn Governance (12 packages)

yarn → npm: prefer-npm-from-yarn, eject-npm-from-yarn, force-npm-from-yarn, block-npm-from-yarn
yarn → pnpm: prefer-pnpm-from-yarn, eject-pnpm-from-yarn, force-pnpm-from-yarn, block-pnpm-from-yarn
yarn → bun: prefer-bun-from-yarn, eject-bun-from-yarn, force-bun-from-yarn, block-bun-from-yarn

bun Governance (12 packages)

bun → npm: prefer-npm-from-bun, eject-npm-from-bun, force-npm-from-bun, block-npm-from-bun
bun → pnpm: prefer-pnpm-from-bun, eject-pnpm-from-bun, force-pnpm-from-bun, block-pnpm-from-bun
bun → yarn: prefer-yarn-from-bun, eject-yarn-from-bun, force-yarn-from-bun, block-yarn-from-bun

pip Governance (3 packages)

pip → uv: prefer-uv, eject-pip, block-pip

Tool Preferences (2 packages)

Environment setup: prefer-devbox
Package manager management: prefer-corepack

Logical Bundle Packages (5 packages)

nodejs-ecosystem - All Node.js package manager governance (npm/pnpm/yarn/bun)
python-ecosystem - Python package manager governance (pip/uv)
dev-tools - Development tool governance (curl/devbox)
migrate-to-pnpm-bundle - Complete npm→pnpm migration bundle
migrate-to-uv-bundle - Complete pip→uv migration bundle

Individual Force Packages

force-uv - Individual package that forces pip→uv (as defined in specs)
force-pnpm - Individual package that forces npm→pnpm
force-devbox - Individual package that forces curl→devbox

Legacy Bundle Package

command-governance - All 47 governance packages in one bundle

Note: force-uv is an individual package (per specs), while migrate-to-uv-bundle is a convenience bundle that includes force-uv + eject-pip + prefer-uv for complete migration scenarios.

Total: 289 individual governance packages + 19 bundle packages = 308 packages

📖 See docs/PACKAGE_LIST.md for the complete detailed list.

🔧 New Features

🔄 Automated RTK Command Sync

Keep RTK wrapper packages synchronized with the official RTK README automatically:

# Run the sync workflow (requires Archon CLI)
bun run cli workflow run sync-rtk-commands

What it does:

Fetches the latest RTK README from GitHub
Extracts all RTK commands from the README
Compares with existing wrapper packages
Generates missing wrapper scripts automatically
Creates Nix derivations for new wrappers
Updates flake.nix and bundle packages
Updates generator scripts
Generates devbox-rtk integrated packages for dev tools
Updates documentation with new package counts
Commits all changes with a descriptive message

Workflow location: .agents/workflows/sync-rtk-commands.yaml (also in .devin/workflows/)

🎯 Dynamic Package Detection

All prefer-* wrappers now intelligently detect available alternatives on your system:

npm install
# ⚠️ Prefer pnpm over npm. Detecting available alternatives...
# ✅ Using pnpm (preferred)
# ℹ️  yarn is also available
# ℹ️  bun is also available
# 💡 Tip: Multiple alternatives detected. Consider standardizing on pnpm for best compatibility.

📦 Logical Bundle Packages

New logical bundles organized by tool categories:

# Node.js ecosystem governance
devbox add github:levonk/levonk-packages#nodejs-ecosystem

# Python ecosystem governance  
devbox add github:levonk/levonk-packages#python-ecosystem

# Development tool guidance
devbox add github:levonk/levonk-packages#dev-tools

# Complete migration scenarios
devbox add github:levonk/levonk-packages#migrate-to-pnpm
devbox add github:levonk/levonk-packages#migrate-to-uv

🎯 Use Cases

Gradual Migration

# Start with gentle guidance
devbox add github:levonk/levonk-packages#prefer-pnpm

# npm commands now warn but still work
npm install
# ⚠️ Prefer pnpm over npm. Running pnpm instead...

Strict Enforcement

# Upgrade to strict replacement
devbox add github:levonk/levonk-packages#force-pnpm

# npm commands transparently use pnpm
npm install
# ✅ Using pnpm instead of npm (forced by policy)...

Complete Block

# Block disallowed tools entirely
devbox add github:levonk/levonk-packages#block-npm

# npm commands are blocked
npm install
# ❌ npm is blocked by policy. Use pnpm or corepack instead.

🧪 Testing

Quick Tests

# Run basic functionality tests
just test

# Run comprehensive test suite
just test-comprehensive

# Test individual packages
just test-internal

Test Coverage

289 individual governance packages tested (115 existing + 92 devbox reminder + 54 RTK wrapper + 8 devbox-auto + 16 devbox-rtk-governance)
19 bundle packages tested (11 existing + 4 RTK bundle + 4 devbox-auto bundle)
303 test scenarios total
Transient devbox environments for isolation
Behavioral validation for all governance types

Test Examples

# Test traditional governance packages
nix run .#prefer-pnpm -- --version
nix run .#block-npm -- --version  # Exits with error

# Test RTK wrapper packages
nix run .#rtk-wrap-ls -- --version
nix run .#rtk-wrap-git -- --version

# Test devbox-auto packages
nix run .#devbox-auto-npm -- --version

# Test integrated devbox-rtk packages
nix run .#devbox-rtk-nodejs-pnpm-force -- --version

# Test bundle packages
nix build .#nodejs-ecosystem
nix build .#python-ecosystem
nix build .#dev-tools
nix build .#migrate-to-pnpm
nix build .#migrate-to-uv
nix build .#bundle-rtk-all
nix build .#bundle-devbox-auto-all

🔧 Installation

Package Managers

Note: Traditional governance packages must be generated first with just generate from this repository. RTK, devbox-auto, and integrated packages work immediately via Nix/Devbox.

Manager	Command
Devbox	`devbox add github:levonk/levonk-packages#prefer-pnpm`
Nix	`nix profile install .#prefer-pnpm`
Nix (build)	`nix build .#prefer-pnpm`
Alpine	`apk add command-prefer-pnpm` (after generation)
Debian/Ubuntu	`sudo apt install command-prefer-pnpm` (after generation)
Fedora	`sudo dnf install command-prefer-pnpm` (after generation)
Arch	`yay -S command-prefer-pnpm` (after generation)
Homebrew	`brew install command-prefer-pnpm` (after generation)
mise	`mise use prefer-pnpm` (after generation)

Installation Examples

RTK Token Optimization Wrappers

# Install individual RTK wrapper
nix profile install .#rtk-wrap-ls
devbox add github:levonk/levonk-packages#rtk-wrap-ls

# Install complete RTK suite
nix profile install .#bundle-rtk-all
devbox add github:levonk/levonk-packages#bundle-rtk-all

Devbox Auto-Environment Management

# Install individual devbox-auto wrapper
nix profile install .#devbox-auto-npm
devbox add github:levonk/levonk-packages#devbox-auto-npm

# Install complete devbox-auto suite
nix profile install .#bundle-devbox-auto-all
devbox add github:levonk/levonk-packages#bundle-devbox-auto-all

Integrated Devbox-RTK-Governance Packages

# Install integrated package (environment + optimization + governance)
nix profile install .#devbox-rtk-nodejs-pnpm-force
devbox add github:levonk/levonk-packages#devbox-rtk-nodejs-pnpm-force

Traditional Governance Packages

# Install traditional governance package
nix profile install .#prefer-pnpm
devbox add github:levonk/levonk-packages#prefer-pnpm

# Install comprehensive governance bundle
nix profile install .#command-governance
devbox add github:levonk/levonk-packages#command-governance

Generate All Packages

# Generate packages for all ecosystems
just generate

# Or generate specific ecosystems
just generate-internal

Development Setup

# Clone repository
git clone https://github.com/levonk/levonk-packages.git
cd levonk-packages

# Bootstrap development environment
just bootstrap

# Build all packages
just build

# Generate packaging for all ecosystems
just generate

# Test functionality
just test

🏗️ Architecture

Behavioral Model

prefer-* - Soft guidance with warnings and delegation
eject-* - Remove tool and block future installation
force-* - Strict replacement with preferred tool
block-* - Complete prohibition with error exit

Dependency Graph

prefer-*     (no dependency)
force-*  →   eject-*
block-*  →   eject-*
eject-*      (base layer)

Cross-Ecosystem Support

This repository generates packages that work across multiple ecosystems:

Nix (flakes, Devbox, home-manager, NixOS) - Available immediately
Alpine Linux (APK) - Generated via just generate
Debian/Ubuntu (APT/DEB) - Generated via just generate
Fedora (RPM) - Generated via just generate
Arch Linux (PKGBUILD) - Generated via just generate
Homebrew (Formula) - Generated via just generate
mise (plugin shims) - Generated via just generate

Note: Run just generate to create packages for all ecosystems from the source wrappers.

🔄 Integration with Existing Workflows

This system integrates seamlessly with the Standard Developer UX Flow:

direnv → devbox → just (*-internal) → cargo

No changes to your existing workflow are required. Governance packages work like any other Devbox package.

Example justfile (No Changes Needed)

build:
    devbox shell build

test:
    devbox shell test

dev:
    devbox shell dev

# Internal targets work unchanged
build-internal:
    npm run build  # Automatically governed

test-internal:
    npm test      # Automatically governed

🧪 Testing

# Test individual packages
nix run .#prefer-pnpm -- --version
nix run .#block-npm -- --version  # Exits with error

# Test bundle package
nix build .#command-governance

# Test with Devbox
devbox add .#prefer-pnpm
npm --version  # Shows governance behavior

📚 Documentation

Technical Specification - Complete technical details
ADR Integration - Devbox workflow integration
Requirements - Original requirements

🤝 Contributing

Fork the repository
Create a feature branch
Add wrapper scripts in wrappers/
Create Nix derivations in nix/
Update packaging generators
Test with just test
Submit a pull request

📄 License

MIT License - see LICENSE file for details.

Name		Name	Last commit message	Last commit date
Latest commit History 25 Commits
.agents/workflows		.agents/workflows
.devin/workflows		.devin/workflows
.github/workflows		.github/workflows
.tickets		.tickets
docs		docs
nix		nix
packaging		packaging
scripts		scripts
test-results		test-results
tests/devbox-reminders		tests/devbox-reminders
wrappers		wrappers
.gitignore		.gitignore
AGENTS.md		AGENTS.md
HANDOFF.md		HANDOFF.md
README.md		README.md
devbox.json		devbox.json
devbox.lock		devbox.lock
flake.lock		flake.lock
flake.nix		flake.nix
justfile		justfile

Folders and files

Latest commit

History

Repository files navigation

Command Preference & Package Governance System

🎯 Purpose

Primary: AI Agent Governance

Secondary: Developer Tool Governance

🚀 Quick Start

RTK Token Optimization Wrappers

Devbox Auto-Environment Management

Integrated Devbox-RTK-Governance Packages

Traditional Governance Packages

With Devbox (Recommended)

With Nix

Other Package Managers

📦 Available Packages

RTK Token Optimization Wrappers (54 packages)

Devbox Auto-Environment Management (8 packages)

Integrated Devbox-RTK-Governance Packages (16 packages)

npm Governance (12 packages)

pnpm Governance (15 packages)

yarn Governance (12 packages)

bun Governance (12 packages)

pip Governance (3 packages)

Tool Preferences (2 packages)

Logical Bundle Packages (5 packages)

Individual Force Packages

Legacy Bundle Package

🔧 New Features

🔄 Automated RTK Command Sync

🎯 Dynamic Package Detection

📦 Logical Bundle Packages

🎯 Use Cases

Gradual Migration

Strict Enforcement

Complete Block

🧪 Testing

Quick Tests

Test Coverage

Test Examples

🔧 Installation

Package Managers

Installation Examples

RTK Token Optimization Wrappers

Devbox Auto-Environment Management

Integrated Devbox-RTK-Governance Packages

Traditional Governance Packages

Generate All Packages

Development Setup

🏗️ Architecture

Behavioral Model

Dependency Graph

Cross-Ecosystem Support

🔄 Integration with Existing Workflows

Example justfile (No Changes Needed)

🧪 Testing

📚 Documentation

🤝 Contributing

📄 License

🔗 Related Projects

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages