Add update` command to check for and install latest version

Author: willwashburn

AGENTS.md

@@ -0,0 +1,17 @@
+# Agent Instructions
+
+Guidelines for AI agents working on this codebase.
+
+## Version Management
+
+When you complete a task that changes functionality:
+
+1. **Bump the version** in `package.json` following [Semantic Versioning](https://semver.org/):
+   - **MAJOR** (1.0.0): Breaking changes
+   - **MINOR** (0.1.0): New features, backwards compatible
+   - **PATCH** (0.0.1): Bug fixes, backwards compatible
+
+2. **Update the changelog** in `CHANGELOG.md`:
+   - Add entry under `## [X.Y.Z] - YYYY-MM-DD`
+   - Use appropriate section: `Added`, `Changed`, `Fixed`, `Removed`
+   - Update the version comparison links at the bottom

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-01-02
+
+### Added
+
+- `update` command to check for and install latest version (`agent-limit update`)
+
 ## [0.6.2] - 2026-01-02
 
 ### Fixed
@@ -87,7 +93,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Standalone binary builds for macOS (arm64 and x64)
 - npm package distribution
 
-[Unreleased]: https://github.com/AgentWorkforce/limit/compare/v0.6.2...HEAD
+[Unreleased]: https://github.com/AgentWorkforce/limit/compare/v0.7.0...HEAD
+[0.7.0]: https://github.com/AgentWorkforce/limit/compare/v0.6.2...v0.7.0
 [0.6.2]: https://github.com/AgentWorkforce/limit/compare/v0.6.0...v0.6.2
 [0.6.0]: https://github.com/AgentWorkforce/limit/compare/v0.5.1...v0.6.0
 [0.5.1]: https://github.com/AgentWorkforce/limit/compare/v0.5.0...v0.5.1

bin/cli.tsx

@@ -27,6 +27,46 @@ if (command === "usage") {
 } else if (command === "version" || command === "--version" || command === "-v") {
   const pkg = await import("../package.json");
   console.log(pkg.version);
+} else if (command === "update") {
+  const pkg = await import("../package.json");
+  const currentVersion = pkg.version;
+  
+  console.log(`Current version: ${currentVersion}`);
+  console.log("Checking for updates...");
+  
+  try {
+    const response = await fetch("https://registry.npmjs.org/agent-limit/latest");
+    if (!response.ok) {
+      throw new Error(`Failed to fetch: ${response.status}`);
+    }
+    const data = await response.json() as { version: string };
+    const latestVersion = data.version;
+    
+    if (latestVersion === currentVersion) {
+      console.log(`✓ You're on the latest version (${currentVersion})`);
+    } else {
+      console.log(`New version available: ${latestVersion}`);
+      console.log("\nUpdating...");
+      
+      const proc = Bun.spawn(["npm", "install", "-g", "agent-limit@latest"], {
+        stdout: "inherit",
+        stderr: "inherit",
+      });
+      
+      const exitCode = await proc.exited;
+      
+      if (exitCode === 0) {
+        console.log(`\n✓ Updated to ${latestVersion}`);
+      } else {
+        console.error("\n✗ Update failed. Try running manually:");
+        console.error("  npm install -g agent-limit@latest");
+        process.exit(1);
+      }
+    }
+  } catch (error) {
+    console.error("Failed to check for updates:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
 } else if (command === "help" || command === "--help" || command === "-h" || !command) {
   console.log(`
 agent-limit
@@ -41,6 +81,7 @@ Quick Start:
 
 CLI:
   agent-limit usage    Show usage dashboard
+  agent-limit update   Update to latest version
   agent-limit version  Show version
   agent-limit help     Show this help message
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-limit",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Terminal dashboard to monitor Claude Code, Codex, and other agent usage limits",
   "type": "module",
   "main": "src/index.tsx",