@mgamil/mapx 0.2.4 → 0.2.5

package/README.md

@@ -2,7 +2,7 @@
 
 **Local code graph memory for LLMs.** Scan your codebase once — instantly query symbols, trace dependencies, analyze impact, and generate structured summaries without re-reading files.
 
-MapX uses [tree-sitter](https://tree-sitter.github.io/) to parse source files across **22 languages**, builds a PageRank-weighted dependency graph, and persists everything to a local SQLite database. Works as a standalone CLI or as an [MCP server](https://modelcontextprotocol.io/) with **25 tools** for Claude Desktop, Cursor, VS Code, and any other MCP-compatible client.
+MapXGraph _-also known as MapX-_ uses [tree-sitter](https://tree-sitter.github.io/) to parse source files across **22 languages**, builds a PageRank-weighted dependency graph, and persists everything to a local SQLite database. Works as a standalone CLI or as an [MCP server](https://modelcontextprotocol.io/) with **25 tools** for Claude Desktop, Cursor, VS Code, and any other MCP-compatible client.
 
 ---
 
@@ -26,7 +26,27 @@ MapX uses [tree-sitter](https://tree-sitter.github.io/) to parse source files ac
 
 ## Installation
 
-### Pre-built binary (recommended)
+### From npm (Global Installation)
+
+Install MapX globally (recommended):
+
+```bash
+npm install -g @mgamil/mapx
+```
+
+### Zero Installation (via npx)
+
+Run MapX directly without installing it globally:
+
+```bash
+# Initialize project
+npx @mgamil/mapx init
+
+# Scan files
+npx @mgamil/mapx scan
+```
+
+### Pre-built binary
 
 Download the latest release for your platform from the [Releases](../../releases) page and place it on your `PATH`:
 
@@ -47,12 +67,6 @@ cd mapx-<version>
 ./install.sh --system         # installs to /usr/local/bin (needs sudo)
 ```
 
-### From npm
-
-```bash
-npm install -g mapx
-```
-
 ### From source
 
 Requires [Node.js](https://nodejs.org/) ≥ 20 or [Bun](https://bun.sh/).
@@ -68,6 +82,9 @@ npx tsx src/main.ts --help
 
 ## Quick Start
 
+> [!TIP]
+> If using the zero-installation method, replace `mapx` with `npx @mgamil/mapx` in the commands below (e.g. `npx @mgamil/mapx init`, `npx @mgamil/mapx scan`).
+
 ```bash
 # 1. Initialize mapx in your project (auto-adds .mapx/ to .gitignore)
 cd /path/to/your/project
@@ -469,20 +486,6 @@ make install-local
 
 ---
 
-## Publishing to npm
-
-To publish new releases of the npm package:
-
-1. Create a tag matching the version in `package.json` and push it:
-   ```bash
-   git tag v0.1.7
-   git push origin v0.1.7
-   ```
-2. The GitHub Actions publish workflow will automatically run, verify version synchronization, build WASM grammars, compile the TypeScript code using `tsup`, and publish to the npm registry with provenance.
-3. **Important**: The workflow requires a repository secret named `NPM_TOKEN`. This token must be generated on `npmjs.com` as an **Automation** access token.
-
----
-
 ## License
 
 Apache 2.0 — see [LICENSE](LICENSE).

package/VERSION

@@ -1 +1 @@
-0.2.4
+0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mgamil/mapx",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "license": "Apache-2.0",
   "description": "Multi-language code graph memory system for LLMs",
   "author": {