Protected CLI for VERTEX Diagnostics & Commit Intelligence
npm install vertex-cliAI-Powered Developer Productivity Tools



macOS • Linux • Windows (WSL)
---
$3Generate perfect conventional commit messages using local AI. No cloud APIs - 100% private. `` | $3TypeScript, ESLint & npm audit with AI-powered error explanations. ` | $3Interactive semantic versioning with auto-commit support. ` |
---
`bash`
npm install -g vertex-cli
That's it! 🎉 All dependencies are auto-installed.
---
`bashStage your changes
git add .
📸 See Example Output
`
██╗ ██╗███████╗██████╗ ████████╗███████╗██╗ ██╗
██║ ██║██╔════╝██╔══██╗╚══██╔══╝██╔════╝╚██╗██╔╝
██║ ██║█████╗ ██████╔╝ ██║ █████╗ ╚███╔╝
╚██╗ ██╔╝██╔══╝ ██╔══██╗ ██║ ██╔══╝ ██╔██╗
╚████╔╝ ███████╗██║ ██║ ██║ ███████╗██╔╝ ██╗
╚═══╝ ╚══════╝╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝ ✓ Changes Detected: 3 files
✓ AI Generated: feat(auth): add OAuth2 login flow
Accept? [Y/n]
`$3
`bash
vertex-check
`Runs comprehensive checks:
- ✅ TypeScript compilation
- ✅ ESLint analysis
- ✅ npm audit security scan
- ✅ Dead code detection
- 🤖 AI error explanations
$3
`bash
vertex-bump
`- 📌 Patch (0.0.x) - Bug fixes
- 🔧 Minor (0.x.0) - New features
- 🚀 Major (x.0.0) - Breaking changes
---
🔧 How It Works
$3
When you run any VERTEX command, it automatically:
`
1️⃣ Detects your OS (macOS / Linux / Windows WSL)
↓
2️⃣ Installs missing dependencies
• gum (terminal UI)
• jq (JSON processing)
• Ollama (local AI engine)
↓
3️⃣ Downloads AI model (qwen2.5-coder:1.5b)
↓
4️⃣ Starts Ollama server
↓
5️⃣ Runs your command! ✨
`$3
| OS | Package Manager |
|:---|:----------------|
| 🍎 macOS | Homebrew |
| 🐧 Ubuntu/Debian | apt |
| 🎩 Fedora/RHEL | dnf |
| 🏔️ Alpine | apk |
| 🔵 Arch | pacman |
| 🪟 Windows | WSL + apt/brew |
---
🔒 Privacy First
- 100% Local AI - Uses Ollama, runs on your machine
- No Cloud APIs - Your code never leaves your computer
- No Data Collection - Zero telemetry
---
💻 System Requirements
| Requirement | Minimum |
|:------------|:--------|
| Node.js | 16+ |
| RAM | 4GB (8GB recommended for AI) |
| Disk | 2GB free space |
$3
VERTEX requires WSL (Windows Subsystem for Linux):
`powershell
Install WSL (run as Administrator)
wsl --installThen install vertex-cli inside WSL
npm install -g vertex-cli
`---
🔗 Integration Guide
$3
1. Update
vite.config.ts
`typescript
import { defineConfig } from "vite";
import packageJson from "./package.json";export default defineConfig({
define: {
__APP_VERSION__: JSON.stringify(packageJson.version),
},
});
`2. Add Type Definition (
src/vite-env.d.ts)
`typescript
declare const __APP_VERSION__: string;
`3. Use in Component
`tsx
v{__APP_VERSION__}
`Now run
vertex-bump and your UI updates automatically! 🎉---
📋 Commands Reference
| Command | Description |
|:--------|:------------|
|
vertex-commit | AI-powered commit message generator |
| vertex-check | Project diagnostics & health check |
| vertex-bump` | Interactive version bumping |---
Contributions welcome! Please open an issue first to discuss changes.
---
MIT © VERTEX
---
Made with 💜 for developers who value their time