depwire-cli 0.2.0 → 0.2.2

package/README.md

@@ -1,5 +1,7 @@
 # Depwire
 
+![Depwire - Arc diagram visualization of the Hono framework](./assets/depwire-hero.png)
+
 **See how your code connects. Give AI tools full codebase context.**
 
 Depwire analyzes codebases to build a cross-reference graph showing how every file, function, and import connects. It provides:
@@ -10,6 +12,46 @@ Depwire analyzes codebases to build a cross-reference graph showing how every fi
 - 👀 **Live updates** — Graph stays current as you edit code
 - 🌍 **Multi-language** — TypeScript, JavaScript, Python, and Go
 
+## Why Depwire?
+
+AI coding tools are flying blind. Every time Claude, Cursor, or Copilot touches your code, it's guessing about dependencies, imports, and impact. The result: broken refactors, hallucinated imports, and wasted tokens re-scanning files it already saw.
+
+**Lost context = lost money + lost time + bad code.**
+
+**Depwire parsed the entire Hono framework — 305 files, 5,636 symbols, 1,565 dependency edges — in 2.3 seconds.**
+
+Depwire fixes this by giving AI tools a complete dependency graph of your codebase — not a fuzzy embedding, not a keyword search, but a deterministic, tree-sitter-parsed map of every symbol and connection.
+
+### Stop Losing Context
+- **No more "start from scratch" chats** — Depwire is the shared knowledge layer that every AI session inherits. New chat? Your AI already knows the architecture.
+- **Stop burning tokens** — AI tools query the graph instead of scanning hundreds of files blindly
+- **One command, every AI tool** — Claude Desktop, Cursor, VS Code, any MCP-compatible tool gets the same complete picture
+
+### Ship Better Code
+- **Impact analysis for any change** — renaming a function, moving a file, upgrading a dependency, deleting a module — know the full blast radius before you touch anything
+- **Refactor with confidence** — see every downstream consumer, every transitive dependency, 2-3 levels deep
+- **Catch dead code** — find symbols nobody references anymore
+
+### Stay in Flow
+- **Live graph, always current** — edit a file and the dependency map updates in real-time. No re-indexing, no waiting.
+- **Works locally, stays private** — zero cloud accounts, zero data leaving your machine. Just `npm install` and go.
+
+### 10 MCP Tools, Not Just Visualization
+Depwire isn't just a pretty graph. It's a full context engine with 10 tools that AI assistants call autonomously — architecture summaries, dependency tracing, symbol search, file context, and more. The AI decides which tool to use based on your question.
+
+## Installation
+
+![Installation](./assets/installation.gif)
+
+```bash
+npm install -g depwire-cli
+```
+
+Or use directly with `npx`:
+```bash
+npx depwire-cli --help
+```
+
 ## Quick Start
 
 ### CLI Usage
@@ -86,6 +128,10 @@ Settings → Features → Experimental → Enable MCP → Add Server:
 
 ## Visualization
 
+![Depwire CLI](./assets/viz-command.gif)
+
+![Interactive Arc Diagram](./assets/graph.gif)
+
 ```bash
 # Open visualization on default port (3456)
 depwire viz ./my-project
@@ -119,17 +165,6 @@ Opens an interactive arc diagram in your browser:
 3. **MCP** — AI tools query the graph for context-aware answers
 4. **Viz** — D3.js renders the graph as an interactive arc diagram
 
-## Installation
-
-```bash
-npm install -g depwire-cli
-```
-
-Or use directly with `npx`:
-```bash
-npx depwire-cli --help
-```
-
 ## CLI Reference
 
 ### `depwire parse <directory>`
@@ -203,6 +238,8 @@ Depwire gracefully handles parse errors:
 
 ### Refactoring with AI
 
+![Claude Desktop with Depwire MCP](./assets/claude.gif)
+
 ```
 # In Claude Desktop or Cursor with Depwire MCP:
 
@@ -267,6 +304,14 @@ Contributions welcome! Please note:
 
 All contributors must sign the Contributor License Agreement before their PR can be merged.
 
+## Author
+
+**Atef Ataya** — AI architect, author, and creator of Depwire.
+
+- 🎥 [YouTube](https://www.youtube.com/@atefataya) — 600K+ subscribers covering AI agents, MCP, and LLMs
+- 📖 [The Architect's Playbook: 5 Pillars](https://www.amazon.com/dp/B0GCHNW2W8) — Best practices for AI agent architecture
+- 💼 [LinkedIn](https://www.linkedin.com/in/atefataya/)
+
 ## License
 
 Depwire is licensed under the [Business Source License 1.1](LICENSE).

package/dist/index.js

@@ -15,8 +15,9 @@ import {
 
 // src/index.ts
 import { Command } from "commander";
-import { resolve } from "path";
+import { resolve, dirname, join } from "path";
 import { writeFileSync, readFileSync, existsSync } from "fs";
+import { fileURLToPath } from "url";
 
 // src/graph/serializer.ts
 import { DirectedGraph } from "graphology";
@@ -85,8 +86,12 @@ function importFromJSON(json) {
 }
 
 // src/index.ts
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var packageJsonPath = join(__dirname, "../package.json");
+var packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
 var program = new Command();
-program.name("depwire").description("Code cross-reference graph builder for TypeScript projects").version("0.1.0");
+program.name("depwire").description("Code cross-reference graph builder for TypeScript projects").version(packageJson.version);
 program.command("parse").description("Parse a TypeScript project and build dependency graph").argument("<directory>", "Project directory to parse").option("-o, --output <path>", "Output JSON file path", "depwire-output.json").option("--pretty", "Pretty-print JSON output").option("--stats", "Print summary statistics").option("--exclude <patterns...>", 'Glob patterns to exclude (e.g., "**/*.test.*" "dist/**")').option("--verbose", "Show detailed parsing progress").action(async (directory, options) => {
   const startTime = Date.now();
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "depwire-cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Code cross-reference visualization and AI context engine for TypeScript. Analyzes codebases to show dependencies, enables AI tools with MCP, and renders beautiful arc diagrams.",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "arc-diagram",
     "cross-reference"
   ],
-  "author": "Depwire",
+  "author": "Atef Ataya (https://www.youtube.com/@atefataya)",
   "license": "BSL-1.1",
   "repository": {
     "type": "git",