@dirxai/cli 0.1.0

package/README.md

@@ -0,0 +1,101 @@
+# DirX — Unified Gateway & CLI for Agents
+
+DirX provides a single CLI that lets AI agents **discover**, **navigate**, and **execute** across any API — GitHub, OpenAI, custom services, and more.
+
+```
+dirx ls /                          # discover registered services
+dirx cat /net/api.github.com       # read service info
+dirx grep "issues" api.github.com  # search endpoints
+dirx write /net/api.github.com/owner/repo/issues --json '{"title":"Bug"}'
+dirx bash 'cat /net | cat /net/api.github.com'
+```
+
+## Install
+
+### npm (recommended)
+
+```bash
+npm install -g @dirxai/cli
+```
+
+### Homebrew (macOS/Linux)
+
+```bash
+brew tap dirxai/dirx
+brew install dirx
+```
+
+### Binary download
+
+Download from [Releases](https://github.com/dirxai/dirx/releases) and add to your PATH.
+
+| Platform | Archive |
+|----------|---------|
+| macOS ARM64 | `dirx-aarch64-apple-darwin.tar.gz` |
+| macOS x86_64 | `dirx-x86_64-apple-darwin.tar.gz` |
+| Linux x86_64 | `dirx-x86_64-unknown-linux-gnu.tar.gz` |
+
+Install:
+
+```bash
+tar xzf dirx-*.tar.gz
+sudo mv dirx /usr/local/bin/
+```
+
+## Quick Start
+
+```bash
+# 1. Authenticate
+dirx auth --server https://api.dirx.ai --json '{}'
+
+# 2. Browse
+dirx ls /
+dirx ls /net
+
+# 3. Read
+dirx cat /net/api.github.com
+
+# 4. Search
+dirx grep "pull requests"
+
+# 5. Manage API keys (BYOK)
+dirx keys set api.github.com --token ghp_your_token
+dirx keys list
+
+# 6. Pipeline
+dirx bash 'cat /net/api.github.com | write /log'
+```
+
+## For Service Developers
+
+Register your API with DirX:
+
+```bash
+dirx init my-service/        # generate DIR.md + dir.json
+dirx claim api.example.com   # start domain verification
+dirx claim api.example.com --verify  # complete verification
+dirx register --domain api.example.com  # publish to registry
+```
+
+## Architecture
+
+```
+CLI (Rust) ──HTTP──▶ DirX Server (Go) ──▶ Adapters ──▶ External APIs
+                     │ Registry          │ GitHub
+                     │ Router            │ OpenAI
+                     │ Auth (JWKS)       │ Custom...
+                     │ Policy
+                     │ Audit
+                     │ BYOK
+                     │ Search
+```
+
+## Documentation
+
+- [dirx.ai](https://dirx.ai) — official site
+- [API Reference](https://dirx.ai/docs/api)
+- [Developer Guide](https://dirx.ai/docs/developers)
+
+## License
+
+MIT

package/install.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+const https = require("https");
+const http = require("http");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { execSync } = require("child_process");
+
+const VERSION = require("./package.json").version;
+const REPO = "dirxai/dirx";
+const BIN_DIR = path.join(__dirname, "bin");
+
+const PLATFORM_MAP = {
+  darwin: "apple-darwin",
+  linux: "unknown-linux-gnu",
+};
+
+const ARCH_MAP = {
+  x64: "x86_64",
+  arm64: "aarch64",
+};
+
+function getArchiveName() {
+  const platform = PLATFORM_MAP[process.platform];
+  const arch = ARCH_MAP[process.arch];
+  if (!platform || !arch) {
+    throw new Error(
+      `Unsupported platform: ${process.platform}-${process.arch}`
+    );
+  }
+  return `dirx-${arch}-${platform}.tar.gz`;
+}
+
+function getDownloadUrl(archiveName) {
+  return `https://github.com/${REPO}/releases/download/v${VERSION}/${archiveName}`;
+}
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const client = url.startsWith("https") ? https : http;
+    client.get(url, { headers: { "User-Agent": "dirx-npm-installer" } }, (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(`Download failed: HTTP ${res.statusCode} from ${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 archiveName = getArchiveName();
+  const url = getDownloadUrl(archiveName);
+  const archivePath = path.join(os.tmpdir(), archiveName);
+  const binPath = path.join(BIN_DIR, "dirx");
+
+  console.log(`Downloading DirX v${VERSION} for ${process.platform}-${process.arch}...`);
+  console.log(`  ${url}`);
+
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+
+  try {
+    const data = await download(url);
+    fs.writeFileSync(archivePath, data);
+
+    execSync(`tar xzf "${archivePath}" -C "${BIN_DIR}"`, { stdio: "inherit" });
+    fs.chmodSync(binPath, 0o755);
+    fs.unlinkSync(archivePath);
+
+    console.log(`DirX v${VERSION} installed to ${binPath}`);
+
+    try {
+      const version = execSync(`"${binPath}" --version`, { encoding: "utf8" }).trim();
+      console.log(`  ${version}`);
+    } catch {
+      // binary works but --version might not exist yet
+    }
+  } catch (err) {
+    console.error(`Failed to install DirX: ${err.message}`);
+    console.error("You can download manually from:");
+    console.error(`  https://github.com/${REPO}/releases/tag/v${VERSION}`);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@dirxai/cli",
+  "version": "0.1.0",
+  "description": "DirX — Unified Gateway & CLI for Agents",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dirxai/dirx"
+  },
+  "homepage": "https://dirx.ai",
+  "keywords": [
+    "dirx",
+    "agent",
+    "cli",
+    "gateway",
+    "api"
+  ],
+  "bin": {
+    "dirx": "bin/dirx"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md"
+  ],
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}