docs: update README for installation instructions and usage examples

.github/workflows/ci.yml

@@ -5,13 +5,14 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
+  workflow_call:
 
 jobs:
-  ci:
+  build:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [20, 22]
+        node-version: [20, 22, 24]
 
     steps:
       - uses: actions/checkout@v4
@@ -31,4 +32,25 @@ jobs:
 
       - run: pnpm build
 
+  test:
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20, 22, 24]
+
+    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

.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
@@ -33,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

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:
 

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"