kungfu-ai 1.0.0

package/README.md

@@ -0,0 +1,55 @@
+# kungfu-ai
+
+Context retrieval and distillation engine for coding agents. Saves tokens, speeds up agent workflows.
+
+## Install
+
+```bash
+npm install -g kungfu-ai
+```
+
+## Usage
+
+```bash
+# Initialize in your project
+kungfu init
+kungfu index
+
+# Search and explore
+kungfu find-symbol MyClass
+kungfu explore-symbol Router
+kungfu ask-context "how does auth work"
+kungfu semantic-search "database connection"
+kungfu callers handleRequest
+
+# Start MCP server (for AI agents)
+kungfu mcp
+```
+
+## What is Kungfu?
+
+Kungfu is an MCP server that gives coding agents (Claude Code, Cursor, etc.) fast, focused access to your codebase — without reading entire files.
+
+**21 MCP tools** including:
+- Symbol search (exact + fuzzy + semantic)
+- Composite tools (explore-symbol, investigate)
+- Call graph (callers/callees)
+- Git history (blame, file log)
+- Context assembly with intent detection
+
+**Supports:** Rust, TypeScript, JavaScript, Python, Go
+
+## Alternative Install
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/denyzhirkov/kungfu/master/install.sh | sh
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/denyzhirkov/kungfu/master/install.ps1 | iex
+```
+
+## Links
+
+- [GitHub](https://github.com/denyzhirkov/kungfu)
+- [Benchmarks](https://github.com/denyzhirkov/kungfu/blob/master/BENCHMARKS.md)

package/bin/kungfu

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const os = require("os");
+
+const ext = os.platform() === "win32" ? ".exe" : "";
+const bin = path.join(__dirname, `kungfu${ext}`);
+
+try {
+  execFileSync(bin, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  if (err.status !== undefined) {
+    process.exit(err.status);
+  }
+  console.error(`kungfu: binary not found at ${bin}`);
+  console.error("  Run 'npm rebuild kungfu-ai' to download it.");
+  process.exit(1);
+}

package/install.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execSync } = require("child_process");
+const fs = require("fs");
+const https = require("https");
+const http = require("http");
+const path = require("path");
+const os = require("os");
+
+const REPO = "denyzhirkov/kungfu";
+const VERSION = require("./package.json").version;
+
+function getPlatform() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const platformMap = {
+    darwin: "darwin",
+    linux: "linux",
+    win32: "windows",
+  };
+
+  const archMap = {
+    x64: "x86_64",
+    arm64: "aarch64",
+  };
+
+  const p = platformMap[platform];
+  const a = archMap[arch];
+
+  if (!p || !a) {
+    console.error(`Unsupported platform: ${platform}-${arch}`);
+    process.exit(1);
+  }
+
+  const ext = platform === "win32" ? ".exe" : "";
+  return { name: `kungfu-${p}-${a}${ext}`, ext };
+}
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const client = url.startsWith("https") ? https : http;
+    client
+      .get(url, { headers: { "User-Agent": "kungfu-ai-npm" } }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          return download(res.headers.location).then(resolve).catch(reject);
+        }
+        if (res.statusCode !== 200) {
+          return reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => resolve(Buffer.concat(chunks)));
+        res.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+async function main() {
+  const { name, ext } = getPlatform();
+  const tag = `v${VERSION}`;
+  const url = `https://github.com/${REPO}/releases/download/${tag}/${name}`;
+
+  const binDir = path.join(__dirname, "bin");
+  const binPath = path.join(binDir, `kungfu${ext}`);
+
+  // Skip if binary already exists (e.g., in CI cache)
+  if (fs.existsSync(binPath)) {
+    const stat = fs.statSync(binPath);
+    if (stat.size > 1000) {
+      return;
+    }
+  }
+
+  console.log(`kungfu: downloading ${name}...`);
+
+  try {
+    const data = await download(url);
+
+    if (!fs.existsSync(binDir)) {
+      fs.mkdirSync(binDir, { recursive: true });
+    }
+
+    fs.writeFileSync(binPath, data);
+    fs.chmodSync(binPath, 0o755);
+
+    console.log(`kungfu: installed to ${binPath}`);
+  } catch (err) {
+    console.error(`kungfu: failed to download binary from ${url}`);
+    console.error(`  ${err.message}`);
+    console.error(`  Check releases: https://github.com/${REPO}/releases`);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "kungfu-ai",
+  "version": "1.0.0",
+  "description": "Context retrieval and distillation engine for coding agents. Saves tokens, speeds up agent workflows.",
+  "keywords": [
+    "ai",
+    "agent",
+    "context",
+    "mcp",
+    "coding-assistant",
+    "token-optimization"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/denyzhirkov/kungfu"
+  },
+  "homepage": "https://github.com/denyzhirkov/kungfu",
+  "bin": {
+    "kungfu": "bin/kungfu"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}