From fc120653139c6983fcb60ff00dda4b98331f7066 Mon Sep 17 00:00:00 2001
From: Sandeep Prasad <sandeep3180@gmail.com>
Date: Mon, 16 Mar 2026 08:17:26 -0400
Subject: [PATCH 1/4] docs: update README for installation instructions and
 usage examples

---
 README.md                 | 16 ++++++++++++++--
 packages/cli/package.json |  2 +-
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index b75108e..e14b0b6 100644
--- a/README.md
+++ b/README.md
@@ -12,10 +12,22 @@ AgentVision gives you that picture.
 
 ## How to Run
 
-```bash
+````bash
 npx @agentvision/cli
+You can also install AgentVision globally for a convenient CLI command:
+
+```bash
+npm install -g @agentvision/cli
+````
+
+Or add an alias for easier access:
+
+```bash
+alias agentvision="npx @agentvision/cli"
 ```
 
+````
+
 Requires Node.js 20+.
 
 ## Quick Start
@@ -32,7 +44,7 @@ agentvision scan --local-only
 
 # Only global/user-level configs
 agentvision scan --global-only
-```
+````
 
 Example output:
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 1fe5087..37e8e7c 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -31,10 +31,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@agentvision/core": "workspace:*",
     "picocolors": "^1.1.1"
   },
   "devDependencies": {
+    "@agentvision/core": "workspace:*",
     "@types/node": "^25.5.0",
     "tsup": "^8.4.0",
     "typescript": "^5.7.0"

From 313d77b13f8604fbecd6540bf34379ee1072d212 Mon Sep 17 00:00:00 2001
From: Sandeep Prasad <sandeep3180@gmail.com>
Date: Mon, 16 Mar 2026 08:19:34 -0400
Subject: [PATCH 2/4] fix: updated pnpm-lock

---
 pnpm-lock.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 57bcf49..4958761 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -23,13 +23,13 @@ importers:
 
   packages/cli:
     dependencies:
-      '@agentvision/core':
-        specifier: workspace:*
-        version: link:../core
       picocolors:
         specifier: ^1.1.1
         version: 1.1.1
     devDependencies:
+      '@agentvision/core':
+        specifier: workspace:*
+        version: link:../core
       '@types/node':
         specifier: ^25.5.0
         version: 25.5.0

From 48fd82a00c75266649501b9eddc89cb2f02ada38 Mon Sep 17 00:00:00 2001
From: Sandeep Prasad <sandeep3180@gmail.com>
Date: Mon, 16 Mar 2026 08:22:12 -0400
Subject: [PATCH 3/4] refactor: streamline CI workflow by reusing ci.yml in
 publish.yml

---
 .github/workflows/ci.yml      | 24 +++++++++++++++++++++++-
 .github/workflows/publish.yml | 13 +------------
 2 files changed, 24 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index cd16ed0..ea5c112 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -5,9 +5,10 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
+  workflow_call:
 
 jobs:
-  ci:
+  build:
     runs-on: ubuntu-latest
     strategy:
       matrix:
@@ -31,4 +32,25 @@ jobs:
 
       - run: pnpm build
 
+  test:
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20, 22]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: pnpm
+
+      - run: pnpm install --frozen-lockfile
+
+      - run: pnpm --filter @agentvision/core build
+
       - run: pnpm test
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 9f2af6b..e6fa2c2 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -8,18 +8,7 @@ concurrency: ${{ github.workflow }}-${{ github.ref }}
 
 jobs:
   ci:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: pnpm typecheck
-      - run: pnpm build
-      - run: pnpm test
+    uses: ./.github/workflows/ci.yml
 
   publish:
     needs: ci

From 158008ad9ca91ca034e7b0b6cf9c081f0b60e0ca Mon Sep 17 00:00:00 2001
From: Sandeep Prasad <sandeep3180@gmail.com>
Date: Mon, 16 Mar 2026 08:24:19 -0400
Subject: [PATCH 4/4] chore: update node version matrix in CI and publish
 workflows to include 24

---
 .github/workflows/ci.yml      | 4 ++--
 .github/workflows/publish.yml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index ea5c112..7ba9717 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [20, 22]
+        node-version: [20, 22, 24]
 
     steps:
       - uses: actions/checkout@v4
@@ -37,7 +37,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [20, 22]
+        node-version: [20, 22, 24]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index e6fa2c2..17e1c54 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -22,7 +22,7 @@ jobs:
       - uses: pnpm/action-setup@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 22
+          node-version: 24
           cache: pnpm
           registry-url: https://registry.npmjs.org
       - run: pnpm install --frozen-lockfile