proagents 1.6.15 → 1.6.16

package/README.md

@@ -9,6 +9,15 @@ A portable, universal development workflow framework that works with **any AI pl
 
 ---
 
+## Why ProAgents?
+
+- **AI-Agnostic**: Works with Claude, ChatGPT, Gemini, Cursor, Copilot - switch AI tools anytime without losing context
+- **Multi-AI Collaboration**: Multiple AIs can work on the same project with shared context and conflict detection
+- **Guided Workflow**: 10-phase development process from Analysis to Deployment with quality gates
+- **Learning System**: AI learns from your corrections and never repeats the same mistakes
+
+---
+
 ## Installation
 
 No install required. Just run:
@@ -23,20 +32,6 @@ Or with a template:
 npx proagents init --template nextjs-saas
 ```
 
-### Upgrading from v1.5.x
-
-Version 1.6.0 renamed `proagents/` to `.proagents/` (following `.github`, `.vscode` convention).
-
-```bash
-cd your-project
-npx proagents migrate
-```
-
-**What migration does:**
-- Renames `proagents/` → `.proagents/`
-- Updates paths in `README.md`, `CLAUDE.md`, `.cursorrules`
-- Preserves all your existing configurations
-
 ---
 
 ## Quick Start
@@ -48,26 +43,37 @@ cd your-project
 npx proagents init
 ```
 
-This creates a `./.proagents/` folder with workflow files, and prompts for:
-- Project name and type (auto-detected)
-- Tech stack (API style, database, styling, auth, etc.)
-- AI platforms to use (Claude, Cursor, Gemini, etc.)
+**What happens:**
+- Creates `./.proagents/` folder with workflow files
+- Prompts for project name and type (auto-detected)
+- Prompts for tech stack (API style, database, styling, auth)
+- Creates AI instruction files (CLAUDE.md, .cursorrules, etc.)
 
 ### 2. Use Commands in Any AI
 
-Type `pa:` commands in your AI assistant:
+Open your AI assistant (Claude, ChatGPT, Cursor, etc.) and type:
 
 ```
 pa:feature "Add user authentication"
-pa:fix "Login button not working"
-pa:status
 ```
 
-### 3. AI Follows the Guided Workflow
+**What happens:**
+- AI loads project context automatically
+- Guides you through 10-phase workflow
+- Logs all changes for other AIs to see
+
+### 3. See Progress
 
 ```
-Init → Analysis → Requirements → Design → Planning →
-Implementation → Testing → Review → Documentation → Deployment
+pa:status
+```
+
+**Example output:**
+```
+Feature: Add user authentication
+Phase: Implementation (5/10)
+Progress: ████████░░░░ 50%
+Next: pa:test
 ```
 
 ---
@@ -155,426 +161,48 @@ ProAgents follows **"ALWAYS DO, NEVER JUST TELL"** principle:
 ## CLI Commands
 
 ```bash
-# Initialization
-npx proagents init                    # Initialize in project
+# Initialize
+npx proagents init                    # Initialize or update ProAgents
 npx proagents init --template <name>  # Use a project template
-npx proagents init --list-templates   # List available templates
-
-# Features & Fixes
-proagents feature start "name"        # Start a new feature
-proagents feature status              # Check feature status
-proagents fix "bug description"       # Quick bug fix mode
 
-# Maintenance
-proagents doctor                      # Health check installation
-proagents doctor --full               # Extended checks (branches, logs, features)
+# Daily Use
 proagents status                      # Show ProAgents status
-proagents version                     # Show detailed version info
-
-# Release Notes
-proagents release                     # Interactive release note generator
-proagents release -t detailed         # Full comprehensive notes
-proagents release -t short            # Quick summary
-proagents release -t client           # Business-focused, non-technical
-proagents release -t developer        # Technical details for devs
-proagents release -t hotfix           # Urgent patch notes
-proagents release -t prerelease       # Beta/RC notes
-proagents release --include fixes     # Only include bug fixes
-proagents release --include features  # Only include features
-proagents release --append -o FILE    # Append to existing notes
-proagents release --bump              # Suggest version bump
-proagents release --module auth       # Filter by module name
-proagents release --changelog         # Update CHANGELOG.md
-proagents release --tag               # Create git tag
-proagents release --json              # JSON output for CI/CD
-
-# Updating ProAgents
-npx proagents init                    # Smart update (recommended)
-proagents upgrade                     # Full replace (use with caution)
+proagents doctor                      # Health check installation
+proagents stats                       # Show project & AI usage stats
 
 # AI Platforms
 proagents ai list                     # List installed AI platforms
 proagents ai add                      # Add more platforms
-proagents ai remove                   # Remove platforms
 
-# Configuration
-proagents config show                 # Show current config
-proagents config setup                # Interactive config wizard
-proagents config export               # Export config for sharing
-proagents config import <file>        # Import config from file
-
-# Statistics & Monitoring
-proagents stats                       # Show project & AI usage stats
-proagents stats --json                # JSON output for scripting
-
-# Changelog Management
-proagents changelog view              # View recent changelog entries
-proagents changelog add "entry"       # Add new changelog entry
-proagents changelog list              # List available changelogs
-proagents changelog export            # Export to CHANGELOG.md
-proagents changelog git               # View git history as changelog
-
-# Backup & Restore
-proagents restore <backup.json>       # Restore from uninstall backup
-
-# Shell Completions
-proagents completion bash             # Generate bash completions
-proagents completion zsh              # Generate zsh completions
-proagents completion fish             # Generate fish completions
-
-# Quick File Access
-proagents open                        # Show available shortcuts
-proagents open config                 # Open proagents.config.yaml
-proagents open changelog              # Open recent changelog
-proagents open activity               # Open activity log
-proagents open context                # Open worklog context
-
-# Other
-proagents docs                        # Open documentation
-proagents commands                    # Show all commands
-proagents uninstall                   # Remove ProAgents
+# Release
+proagents release                     # Generate release notes
+proagents release --changelog         # Update CHANGELOG.md
 ```
 
-### Updating ProAgents
-
-| Command | What It Does | When to Use |
-|---------|--------------|-------------|
-| `npx proagents init` | **Smart update** - Updates 60 framework folders, merges config, preserves your work | **Recommended** for regular updates |
-| `proagents upgrade` | **Full replace** - Removes everything, installs fresh, restores backups | Only when you need a complete reset |
-
-**What's preserved with `init` (smart update):**
-- `active-features/` - Your work in progress
-- `changelog/` - Your change history (_recent.md, modules/, features/)
-- `worklog/` - Your work context (_context.md, ai-stats.json)
-- `.learning/` - Learned patterns
-- `cache/` - Analysis cache
-- `proagents.config.yaml` - Your values kept, new options merged
-
-**What's preserved with `upgrade` (full replace):**
-- `proagents.config.yaml`, `activity.log`, `handoff.md`, `.lock`
-- `active-features/` - All files
-- `changelog/` - _recent.md, modules/, features/, yearly folders
-- `worklog/` - _context.md, ai-stats.json
+Run `proagents commands` for the full list of CLI commands.
 
 ---
 
-## AI Commands (pa:)
+## Essential AI Commands (pa:)
 
 Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.):
 
-### Quick Aliases
-| Alias | Expands To |
-|-------|------------|
-| `pa:f` | `pa:feature` |
-| `pa:s` | `pa:status` |
-| `pa:h` | `pa:help` |
-| `pa:d` | `pa:doc` |
-| `pa:t` | `pa:test` |
-| `pa:q` | `pa:qa` |
-| `pa:a` | `pa:analyze` |
-| `pa:r` | `pa:requirements` |
-| `pa:p` | `pa:plan` |
-| `pa:i` | `pa:implement` |
-| `pa:rev` | `pa:review` |
-| `pa:dbg` | `pa:debug` |
-| `pa:l` | `pa:logs` |
-
-### Core Commands
 | Command | Description |
 |---------|-------------|
 | `pa:feature "name"` | Start new feature workflow (all phases) |
 | `pa:fix "description"` | Quick bug fix mode |
 | `pa:status` | Show current progress |
+| `pa:sync` | Load project context (usually auto) |
+| `pa:test` | Run tests |
+| `pa:review` | Code review workflow |
+| `pa:deploy` | Deployment preparation |
 | `pa:help` | Show all commands |
+| `pa:undo-last` | Revert last AI's changes |
+| `pa:handoff` | Create notes for another AI |
 
-### Workflow Phase Commands
-| Command | Phase | Description |
-|---------|-------|-------------|
-| `pa:analyze` | Analysis | Deep codebase analysis |
-| `pa:requirements` | Requirements | Gather feature requirements |
-| `pa:design` | Design | UI/Architecture design |
-| `pa:plan` | Planning | Create implementation plan |
-| `pa:implement` | Implementation | Execute code changes |
-| `pa:test` | Testing | Create and run tests |
-| `pa:review` | Review | Code review workflow |
-| `pa:doc` | Documentation | Generate documentation |
-| `pa:deploy` | Deployment | Deployment preparation |
-
-### Documentation
-| Command | Description |
-|---------|-------------|
-| `pa:doc` | Generate documentation |
-| `pa:changelog` | Update CHANGELOG.md |
-| `pa:release` | Generate release notes |
+**Quick aliases:** `pa:f` (feature), `pa:s` (status), `pa:t` (test), `pa:h` (help)
 
-### Quality & Testing
-| Command | Description |
-|---------|-------------|
-| `pa:qa` | Run quality assurance checks |
-| `pa:rollback` | Rollback procedures |
-
-### Cross-AI Continuity
-| Command | Description |
-|---------|-------------|
-| `pa:sync` | **Run first** - Load project context |
-| `pa:resume` | Quick resume - shows last session + next action |
-| `pa:session-start` | Begin new work session |
-| `pa:session-end` | Finalize session, update logs |
-| `pa:conflict-check` | Check if files modified by other AI |
-| `pa:undo-last` | Undo last AI's entire session (revert all changes) |
-| `pa:undo-file "path"` | Undo changes to specific file |
-| `pa:changelog` | Update all changelogs |
-| `pa:changelog --from-git` | Auto-populate from git commits |
-| `pa:changelog-feature X` | View feature changelog |
-| `pa:changelog-module X` | View module changelog |
-| `pa:history` | View command history |
-| `pa:activity` | Show recent AI activity |
-| `pa:handoff` | Create handoff notes |
-
-### Learning & Tracking
-| Command | Description |
-|---------|-------------|
-| `pa:decision "title"` | Log architectural decision |
-| `pa:decisions` | Show all decisions |
-| `pa:error "description"` | Log error and solution |
-| `pa:errors` | Search past errors |
-| `pa:feedback "description"` | Log feedback for AI learning |
-
-### AI Platform Management
-| Command | Description |
-|---------|-------------|
-| `pa:ai-list` | List installed AI platforms |
-| `pa:ai-add` | Add more AI platforms |
-| `pa:ai-sync` | Sync config with files |
-
-### Navigation & Flow
-| Command | Description |
-|---------|-------------|
-| `pa:next` | Show next step in workflow |
-| `pa:resume` | Resume paused feature |
-| `pa:skip` | Skip current phase |
-| `pa:back` | Go to previous phase |
-| `pa:progress` | Show visual progress bar |
-
-### Context & History
-| Command | Description |
-|---------|-------------|
-| `pa:context` | View project context |
-| `pa:diff` | Show changes since last session |
-| `pa:history` | Show command history |
-| `pa:checkpoint` | Create restore point |
-| `pa:undo` | Undo last action |
-
-### Sprint & Estimation
-| Command | Description |
-|---------|-------------|
-| `pa:sprint-start` | Start new sprint |
-| `pa:sprint-end` | End sprint with summary |
-| `pa:estimate` | Estimate task complexity |
-| `pa:velocity` | Show velocity metrics |
-
-### Integration
-| Command | Description |
-|---------|-------------|
-| `pa:github` | GitHub integration |
-| `pa:github-pr` | Create pull request |
-| `pa:jira` | Sync with Jira |
-| `pa:notify` | Send notification |
-
-### Code Quality
-| Command | Description |
-|---------|-------------|
-| `pa:metrics` | Code quality metrics |
-| `pa:coverage` | Test coverage report |
-| `pa:deps` | Analyze dependencies |
-| `pa:deps-outdated` | Find outdated packages |
-| `pa:deps-security` | Security scan |
-
-### Code Generation
-| Command | Description |
-|---------|-------------|
-| `pa:generate` | Show generation options |
-| `pa:generate-component` | Generate component |
-| `pa:generate-api` | Generate API endpoint |
-| `pa:generate-test` | Generate test file |
-
-### Refactoring
-| Command | Description |
-|---------|-------------|
-| `pa:refactor` | Suggest refactoring |
-| `pa:rename` | Rename across codebase |
-| `pa:extract` | Extract function/component |
-| `pa:cleanup` | Remove dead code |
-
-### Time Tracking
-| Command | Description |
-|---------|-------------|
-| `pa:time-start` | Start time tracking |
-| `pa:time-stop` | Stop tracking |
-| `pa:time-report` | Show time report |
-
-### Environment & Database
-| Command | Description |
-|---------|-------------|
-| `pa:env-check` | Verify environment |
-| `pa:secrets-scan` | Scan for secrets |
-| `pa:db-migrate` | Run migrations |
-| `pa:db-seed` | Seed database |
-
-### Accessibility & Performance
-| Command | Description |
-|---------|-------------|
-| `pa:a11y` | Accessibility audit |
-| `pa:lighthouse` | Lighthouse audit |
-| `pa:perf` | Performance analysis |
-
-### Export & Learning
-| Command | Description |
-|---------|-------------|
-| `pa:export` | Export config/data |
-| `pa:import` | Import data |
-| `pa:backup` | Backup proagents |
-| `pa:learn` | Teach AI a pattern |
-| `pa:suggestions` | Show AI suggestions |
-
-### API & Documentation
-| Command | Description |
-|---------|-------------|
-| `pa:api-docs` | Generate OpenAPI/Swagger docs |
-| `pa:storybook` | Generate Storybook stories |
-| `pa:readme` | Auto-generate/update README |
-| `pa:types` | Generate TypeScript types |
-
-### Git Advanced
-| Command | Description |
-|---------|-------------|
-| `pa:branch` | Branch management |
-| `pa:merge` | Smart merge with conflict preview |
-| `pa:conflict` | Resolve merge conflicts with AI |
-| `pa:changelog-gen` | Auto-generate changelog |
-
-### Search & Code Navigation
-| Command | Description |
-|---------|-------------|
-| `pa:find` | Find code patterns/usage |
-| `pa:todo` | Find all TODOs in code |
-| `pa:fixme` | Find FIXMEs and critical issues |
-| `pa:unused` | Find unused code/exports |
-
-### Code Analysis
-| Command | Description |
-|---------|-------------|
-| `pa:complexity` | Cyclomatic complexity analysis |
-| `pa:duplication` | Find duplicate code blocks |
-| `pa:hotspots` | Find frequently changed files |
-
-### Debug & Logs
-| Command | Description |
-|---------|-------------|
-| `pa:debug` | Start debug session |
-| `pa:debug-add` | Add debug logs to code |
-| `pa:debug-add "file"` | Add logs to specific file |
-| `pa:debug-trace "func"` | Add entry/exit logs to function |
-| `pa:debug-var "var"` | Track variable changes |
-| `pa:debug-api` | Add API request/response logging |
-| `pa:debug-state` | Add state change logging |
-| `pa:debug-error` | Add error boundary logging |
-| `pa:debug-web` | Web console debugging |
-| `pa:debug-rn` | React Native debugging |
-| `pa:debug-android` | Android native (logcat) |
-| `pa:debug-ios` | iOS native debugging |
-| `pa:logs` | View recent logs |
-| `pa:logs-filter "term"` | Filter logs by term |
-| `pa:debug-clean` | Remove all debug statements |
-
-### Testing Advanced
-| Command | Description |
-|---------|-------------|
-| `pa:test-e2e` | Create/run E2E tests |
-| `pa:test-unit` | Generate unit tests |
-| `pa:mock` | Generate mocks/stubs |
-| `pa:snapshot` | Snapshot testing management |
-
-### DevOps & Infrastructure
-| Command | Description |
-|---------|-------------|
-| `pa:docker` | Docker commands |
-| `pa:ci` | CI/CD pipeline management |
-| `pa:deploy-preview` | Deploy preview environment |
-
-### Release Management
-| Command | Description |
-|---------|-------------|
-| `pa:version` | Show/bump version |
-| `pa:tag` | Create git tag |
-| `pa:publish` | Publish package to registry |
-
-### Code Review & PR
-| Command | Description |
-|---------|-------------|
-| `pa:review-request` | Request code review from team |
-| `pa:review-comments` | Show PR review comments |
-| `pa:review-approve` | Approve current PR |
-
-### Architecture
-| Command | Description |
-|---------|-------------|
-| `pa:architecture` | Show architecture overview |
-| `pa:architecture-diagram` | Generate diagram (Mermaid) |
-| `pa:architecture-export` | Export diagram (SVG/PNG) |
-
-### API Testing
-| Command | Description |
-|---------|-------------|
-| `pa:api-test` | Test API endpoints |
-| `pa:curl` | Generate curl commands |
-| `pa:postman` | Generate Postman collection |
-
-### Health & Monitoring
-| Command | Description |
-|---------|-------------|
-| `pa:health` | Project health check |
-| `pa:monitor` | Show monitoring status |
-| `pa:uptime` | Service uptime check |
-
-### Quick Actions
-| Command | Description |
-|---------|-------------|
-| `pa:quick` | Show quick actions menu |
-| `pa:alias` | Manage command aliases |
-| `pa:alias-add` | Add custom alias |
-| `pa:alias-remove` | Remove custom alias |
-
-### Platform-Specific Test Suites
-
-**Fully automated**: Auto-install tools, run tests, auto-fix failures, loop until all pass.
-
-| Command | Description |
-|---------|-------------|
-| `pa:test-mobile` | Full mobile test suite (React Native, Android, iOS, Flutter) |
-| `pa:test-web` | Full web test suite (React/Next.js/Vue) |
-| `pa:test-api` | Full API test suite (Node.js/Python) |
-| `pa:test-visual` | Visual/design comparison testing |
-| `pa:test-auto-fix` | Auto-fix failing tests |
-| `pa:test-loop` | Test → Fix → Retest until all pass |
-| `pa:compare-figma` | Compare UI against Figma design |
-| `pa:compare-image` | Compare UI against image/sketch |
-| `pa:screenshot` | Capture app screenshots |
-
-**What these commands do:**
-- Check required tools → Auto-install if missing
-- Run all tests (unit, integration, e2e)
-- Auto-fix failures (no confirmation needed)
-- Loop until all pass or fix is impossible
-
-### Custom Commands
-| Command | Description |
-|---------|-------------|
-| `pa:standup` | Generate daily standup |
-| `pa:tech-debt` | Scan for technical debt |
-| `pa:security-scan` | Run security checklist |
-
-Define your own in `./.proagents/custom-commands.yaml`
+For the complete command reference (100+ commands), see **[COMMANDS.md](COMMANDS.md)**.
 
 ---
 
@@ -594,75 +222,10 @@ After initialization, these files help AI understand your project:
 
 ---
 
-## Project Structure
-
-```
-your-project/
-├── .proagents/
-│   ├── proagents.config.yaml   # Project configuration
-│   ├── AI_INSTRUCTIONS.md      # Instructions for all AIs
-│   ├── PROAGENTS.md            # Quick command reference
-│   ├── context.md              # Persistent project context
-│   ├── feedback.md             # AI learning from corrections
-│   ├── watchlist.yaml          # Protected files
-│   ├── activity.log            # AI activity log
-│   ├── decisions.md            # Decision log
-│   ├── errors.md               # Error tracker
-│   ├── handoff.md              # Handoff notes
-│   ├── custom-commands.yaml    # Custom pa: commands
-│   ├── worklog/                # Cross-AI session tracking
-│   │   ├── _context.md         # Quick context for any AI
-│   │   ├── ai-stats.json       # AI performance stats
-│   │   └── YYYY-MM-DD-ai-*.md  # Session logs
-│   ├── changelog/              # Detailed changelogs
-│   │   ├── _recent.md          # Last 10 changes
-│   │   ├── features/           # Per-feature changelogs
-│   │   └── modules/            # Per-module changelogs
-│   ├── active-features/        # Feature tracking
-│   ├── prompts/                # Workflow prompts
-│   ├── templates/              # Document templates
-│   ├── checklists/             # Quality checklists
-│   └── ...
-├── CLAUDE.md                   # Claude-specific instructions
-├── .cursorrules                # Cursor-specific instructions
-├── GEMINI.md                   # Gemini-specific instructions
-└── proagents.config.yaml       # Main config (project root)
-```
-
----
-
-## Configuration
-
-`proagents.config.yaml` stores your project settings:
-
-```yaml
-project:
-  name: my-app
-  type: nextjs
-
-automation:
-  decisions:
-    architecture:
-      api_style: rest
-      state_management: zustand
-      styling: tailwind
-      database: postgresql
-      orm: prisma
-      auth_method: jwt
-    testing:
-      framework: vitest
-      coverage_target: 80
-
-platforms:
-  - claude
-  - cursor
-  - copilot
-```
-
----
-
 ## Supported AI Platforms
 
+ProAgents works with **any AI that has agentic capability** (can read files and execute commands). Pre-configured instruction files are available for:
+
 | Platform | Instruction File |
 |----------|-----------------|
 | Claude Code | `CLAUDE.md` |
@@ -677,17 +240,7 @@ platforms:
 | Kiro | `KIRO.md` |
 | Groq | `GROQ.md` |
 
----
-
-## Integrations
-
-**Project Management:** Jira, Linear, GitHub Issues, GitLab Issues, Asana, Trello, Notion
-
-**Version Control:** GitHub, GitLab
-
-**Communication:** Slack
-
-**CI/CD:** GitHub Actions, GitLab CI, Jenkins, Azure DevOps
+**Using a different AI?** Point it to `.proagents/AI_INSTRUCTIONS.md` - it contains everything needed to work with ProAgents.
 
 ---
 

package/bin/proagents.js

@@ -12,7 +12,7 @@ import { configListCommand, configShowCommand, configEditCommand, configSetComma
 import { doctorCommand } from '../lib/commands/doctor.js';
 import { upgradeCommand } from '../lib/commands/upgrade.js';
 import { migrateCommand } from '../lib/commands/migrate.js';
-import { versionCommand } from '../lib/commands/version.js';
+import { versionCommand, checkForUpdates } from '../lib/commands/version.js';
 import { releaseCommand } from '../lib/commands/release.js';
 import { statsCommand } from '../lib/commands/stats.js';
 import { restoreCommand } from '../lib/commands/restore.js';
@@ -314,3 +314,11 @@ program
   .action(openCommand);
 
 program.parse();
+
+// Check for updates after command completes (non-blocking)
+// Skip for version command (it already shows version info)
+const commandName = program.args[0];
+if (commandName !== 'version' && commandName !== '--version' && commandName !== '-V') {
+  // Run update check in background without blocking
+  checkForUpdates().catch(() => {});
+}

package/lib/commands/version.js

@@ -9,7 +9,7 @@ const __dirname = dirname(__filename);
 /**
  * Get CLI version from package.json
  */
-function getCliVersion() {
+export function getCliVersion() {
   try {
     const packagePath = join(__dirname, '..', '..', 'package.json');
     const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
@@ -41,7 +41,7 @@ function getProjectVersion(targetDir) {
 /**
  * Fetch latest version from npm
  */
-async function getLatestVersion() {
+export async function getLatestVersion() {
   try {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 5000);
@@ -66,7 +66,7 @@ async function getLatestVersion() {
  * Compare semantic versions
  * Returns: -1 if v1 < v2, 0 if equal, 1 if v1 > v2
  */
-function compareVersions(v1, v2) {
+export function compareVersions(v1, v2) {
   const parts1 = v1.split('.').map(Number);
   const parts2 = v2.split('.').map(Number);
 
@@ -79,6 +79,27 @@ function compareVersions(v1, v2) {
   return 0;
 }
 
+/**
+ * Check for updates and display notification if available
+ * Non-blocking - runs asynchronously
+ */
+export async function checkForUpdates() {
+  try {
+    const cliVersion = getCliVersion();
+    const latestVersion = await getLatestVersion();
+
+    if (latestVersion && compareVersions(cliVersion, latestVersion) < 0) {
+      console.log('');
+      console.log(chalk.yellow(`  ╭───────────────────────────────────────────────╮`));
+      console.log(chalk.yellow(`  │  Update available: ${chalk.gray('v' + cliVersion)} → ${chalk.green('v' + latestVersion)}              │`));
+      console.log(chalk.yellow(`  │  Run: ${chalk.cyan('npx proagents init')} to update         │`));
+      console.log(chalk.yellow(`  ╰───────────────────────────────────────────────╯`));
+    }
+  } catch (error) {
+    // Silently ignore update check errors
+  }
+}
+
 /**
  * Version command - show detailed version information
  */
@@ -118,7 +139,7 @@ export async function versionCommand(options = {}) {
         console.log(chalk.green('v' + latestVersion + ' (up to date)'));
       } else {
         console.log(chalk.yellow('v' + latestVersion + ' (update available)'));
-        console.log(chalk.yellow(`                    ↳ Run 'npm update -g proagents' to update`));
+        console.log(chalk.yellow(`                    ↳ Run 'npx proagents init' to update`));
       }
     } else {
       console.log(chalk.gray('Could not fetch (offline or npm unavailable)'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proagents",
-  "version": "1.6.15",
+  "version": "1.6.16",
   "description": "AI-agnostic development workflow framework that automates the full software development lifecycle",
   "type": "module",
   "main": "lib/index.js",