@byteask/cli 0.1.1

package/README.md

@@ -0,0 +1,130 @@
+# ByteAsk
+
+**An AI coding agent for your terminal.** Like Claude Code or Codex, `byteask` drops
+a capable agent into your shell — an interactive TUI, real tool use, and first-class
+C/C++ tooling — talking to the self-hosted ByteAsk gateway.
+
+[![PyPI](https://img.shields.io/pypi/v/byteask.svg)](https://pypi.org/project/byteask/)
+[![npm](https://img.shields.io/npm/v/@byteask/cli.svg)](https://www.npmjs.com/package/@byteask/cli)
+[![Python](https://img.shields.io/pypi/pyversions/byteask.svg)](https://pypi.org/project/byteask/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://code.byteask.ai)
+
+```console
+$ byteask
+```
+
+That's it — one command drops you into an interactive session, the same way `claude`
+or `codex` do. First run signs you in; after that, just type.
+
+---
+
+## Install
+
+Pick whichever fits your setup — they all install the same native engine and share one
+runtime, so switching between them is free.
+
+**pip**
+```bash
+pip install byteask
+```
+
+**npm**
+```bash
+npm install -g @byteask/cli
+# or, no install:
+npx @byteask/cli
+```
+
+**Shell (Linux / macOS)**
+```bash
+curl -fsSL https://code.byteask.ai/install.sh | sh
+```
+
+**PowerShell (Windows)**
+```powershell
+irm https://code.byteask.ai/install.ps1 | iex
+```
+
+The `pip` and `npm` packages are thin launchers: on first run they fetch the native
+engine into `~/.byteask/runtime` and hand off to it. Nothing else on your machine
+changes.
+
+---
+
+## Quickstart
+
+```bash
+# 1. Sign in (magic link to your email) — or just run `byteask`, it onboards you.
+byteask login --email you@company.com
+
+# 2. Start coding, interactively:
+byteask
+
+# 3. Or one-shot a question against the current repo:
+byteask "explain what this service does and where the entrypoint is"
+```
+
+Inside the session, type your task in plain English. The agent reads files, runs
+tools, and proposes edits — you stay in control of what it applies.
+
+---
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `byteask` | Open the interactive agent (the default) |
+| `byteask "…"` | Run a one-shot prompt against the current directory |
+| `byteask login` | Sign in (magic link → token) |
+| `byteask logout` | Sign out on this machine |
+| `byteask --update` | Update to the latest engine |
+| `byteask --version` | Print the version |
+
+Inside the TUI, slash commands include **`/login`**, **`/logout`**, **`/usage`** (your
+quota), **`/upgrade`** (Pro / Max), **`/referral-code`**, and **`/status`**.
+
+---
+
+## What you get
+
+- **Interactive TUI** — a real terminal agent, not a chat box: it navigates the repo,
+  runs commands, and shows diffs before applying.
+- **First-class C/C++ tooling** — 16 native tools wired in: Compiler Explorer
+  (godbolt), `gdb`/`lldb`, ASan/UBSan/valgrind, `clang-tidy`, `clang-format`, `clangd`
+  navigation, `perf`/callgrind, quick-bench, cppinsights, objdump/nm/readelf, Intel
+  intrinsics lookup, and more. The agent reaches for them on the tasks that need them.
+- **Web search** built in.
+- **Zero data retention** — your prompts and code are not used to train models.
+- **Usage that's visible** — `/usage` shows exactly where you stand; upgrade in-app
+  with `/upgrade`.
+
+---
+
+## Platforms
+
+| OS | Architecture | libc |
+| --- | --- | --- |
+| Linux | x86_64, arm64 | glibc |
+| macOS | Apple Silicon (arm64) | — |
+| Windows | x86_64 | — |
+
+> Alpine / musl isn't supported (a core dependency ships no musl build). On Alpine,
+> use WSL or a glibc base image.
+
+---
+
+## How it works
+
+`byteask` is a thin client. The intelligence and your account live behind the ByteAsk
+gateway; the local binary is the agent runtime plus a small launcher that handles
+sign-in, updates, and your config in `~/.byteask`. Your model key never touches your
+machine.
+
+---
+
+## Links
+
+- Home: <https://code.byteask.ai>
+- Install script: <https://code.byteask.ai/install.sh>
+
+MIT licensed.

package/bin/byteask.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+"use strict";
+// ByteAsk npm launcher (thin bootstrapper).
+//
+// On first run it installs the native ByteAsk engine + wrapper into a shared
+// runtime dir (~/.byteask/runtime) via the same installer the curl|sh path uses,
+// then execs the wrapper. All the real logic (login, onboarding, update check,
+// /login|/logout loop) lives in that native wrapper — this file only bootstraps.
+// The runtime dir is shared with the pip package, so the engine downloads once.
+
+const { spawnSync } = require("child_process");
+const { existsSync, mkdirSync } = require("fs");
+const path = require("path");
+const os = require("os");
+
+const BUNDLE = (process.env.BYTEASK_BUNDLE_URL || "https://code.byteask.ai").replace(/\/+$/, "");
+const HOME = process.env.BYTEASK_HOME || path.join(os.homedir(), ".byteask");
+const VENDOR = path.join(HOME, "runtime");
+const isWin = process.platform === "win32";
+const wrapper = path.join(VENDOR, isWin ? "byteask.ps1" : "byteask");
+const engine = path.join(VENDOR, isWin ? "byteask-engine.exe" : "byteask-engine");
+
+function run(cmd, args) {
+  return spawnSync(cmd, args, { stdio: "inherit" });
+}
+
+function ensureInstalled() {
+  if (existsSync(engine) && existsSync(wrapper)) return;
+  mkdirSync(VENDOR, { recursive: true });
+  process.stderr.write("[byteask] first run: fetching the ByteAsk engine (one time)...\n");
+  let r;
+  if (isWin) {
+    const ps =
+      "$ErrorActionPreference='Stop'; $env:PREFIX=" +
+      JSON.stringify(VENDOR) +
+      "; iex (irm " +
+      JSON.stringify(BUNDLE + "/install.ps1") +
+      ")";
+    r = run("powershell", ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", ps]);
+  } else {
+    const sh =
+      "curl -fsSL " +
+      JSON.stringify(BUNDLE + "/install.sh") +
+      " | PREFIX=" +
+      JSON.stringify(VENDOR) +
+      " sh";
+    r = run("sh", ["-c", sh]);
+  }
+  if (!r || r.status !== 0 || !existsSync(engine)) {
+    process.stderr.write(
+      "[byteask] install failed. Try the direct installer:  curl -fsSL " + BUNDLE + "/install.sh | sh\n"
+    );
+    process.exit(1);
+  }
+}
+
+ensureInstalled();
+const args = process.argv.slice(2);
+const r = isWin
+  ? run("powershell", ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", wrapper].concat(args))
+  : run("sh", [wrapper].concat(args));
+process.exit(r.status === null ? 1 : r.status);

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@byteask/cli",
+  "version": "0.1.1",
+  "description": "ByteAsk - AI coding agent CLI for your terminal. Run `npx @byteask/cli` or `npm i -g @byteask/cli`.",
+  "bin": {
+    "byteask": "bin/byteask.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "keywords": [
+    "byteask",
+    "ai",
+    "coding-agent",
+    "cli",
+    "tui"
+  ],
+  "license": "MIT",
+  "homepage": "https://code.byteask.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ByteAsk/byteask-gateway.git",
+    "directory": "byteask/dist/npm"
+  }
+}