clawdos-cli 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# clawdos-cli
+
+**ClawdOS 2.0** — the agent OS that watches Base, from your terminal.
+
+```
+  ██████╗ ██╗      █████╗ ██╗    ██╗██████╗  ██████╗ ███████╗
+ ██╔════╝ ██║     ██╔══██╗██║    ██║██╔══██╗██╔═══██╗██╔════╝
+ ██║      ██║     ███████║██║ █╗ ██║██║  ██║██║   ██║███████╗
+ ██║      ██║     ██╔══██║██║███╗██║██║  ██║██║   ██║╚════██║
+ ╚██████╗ ███████╗██║  ██║╚███╔███╔╝██████╔╝╚██████╔╝███████║
+  ╚═════╝ ╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═════╝  ╚═════╝ ╚══════╝
+                                                          2.0
+```
+
+Token prices, wallet stats, trending launches, gas, TVL — natural
+language or slash commands, no auth needed for basic use.
+
+## Install
+
+```bash
+npm install -g clawdos-cli
+```
+
+Then:
+
+```bash
+clawd
+```
+
+## Commands
+
+| Command           | What it does                                      |
+| ----------------- | ------------------------------------------------- |
+| `/price <token>`  | Token price + 24h change + mcap + liquidity (Dexscreener) |
+| `/wallet <addr>`  | ETH balance + EOA/contract status on Base         |
+| `/gas`            | Base gas price + cost estimates in USD            |
+| `/trending`       | Boosted / trending Base tokens                    |
+| `/new`            | Newest Base token launches (last 24h)             |
+| `/tvl`            | Base chain TVL + top protocols (DefiLlama)        |
+| `/scan <addr>`    | Quick on-chain summary (wallet or token)          |
+| `/login <fal-key>`| Set fal.ai key to enable natural-language mode    |
+| `/whoami`         | Show your session config                          |
+| `/clear`          | Clear terminal                                    |
+| `/help`           | All commands                                      |
+| `/exit`           | Quit (or Ctrl+D)                                  |
+
+## Natural language (optional)
+
+Set a [fal.ai](https://fal.ai) API key to ask questions in plain English:
+
+```
+/login <your-fal-key>
+```
+
+Then:
+
+```
+▸ what is the price of degen on base
+▸ show me wallet 0xabc...
+▸ is gas expensive right now
+▸ what just launched on base in the last day
+▸ tvl
+```
+
+Routes through claude-sonnet-4.5 to classify intent and dispatch to
+the right slash command.
+
+## Privacy + cost
+
+- All data fetched from public APIs (Dexscreener, DeFi Llama, Base RPC,
+  CoinGecko). No auth or sign-in for the core commands.
+- The optional natural-language mode calls fal.ai with your own key —
+  ClawdOS doesn't see or store your key anywhere besides
+  `~/.config/clawdos/config.json` on your machine.
+- Free except for fal.ai's own per-token billing if you enable NL mode.
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,696 @@
+#!/usr/bin/env node
+
+// src/config.ts
+import { homedir } from "os";
+import { join, dirname } from "path";
+import { mkdir, readFile, writeFile, chmod } from "fs/promises";
+var CONFIG_DIR = process.platform === "win32" ? join(process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"), "clawdos") : join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "clawdos");
+var CONFIG_PATH = join(CONFIG_DIR, "config.json");
+async function loadConfig() {
+  try {
+    const raw = await readFile(CONFIG_PATH, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function saveConfig(cfg) {
+  await mkdir(dirname(CONFIG_PATH), { recursive: true });
+  await writeFile(CONFIG_PATH, JSON.stringify(cfg, null, 2), "utf-8");
+  if (process.platform !== "win32") {
+    try {
+      await chmod(CONFIG_PATH, 384);
+    } catch {
+    }
+  }
+}
+
+// src/repl.ts
+import { createInterface } from "readline/promises";
+
+// src/commands.ts
+import { createPublicClient, http, formatEther } from "viem";
+import { base } from "viem/chains";
+
+// src/theme.ts
+import chalk from "chalk";
+var cyan = chalk.hex("#22d3ee");
+var cyanSoft = chalk.hex("#67e8f9");
+var cyanDeep = chalk.hex("#0891b2");
+var violet = chalk.hex("#a78bfa");
+var violetSoft = chalk.hex("#c4b5fd");
+var ink = chalk.hex("#71717a");
+var inkDim = chalk.hex("#52525b");
+var marble = chalk.hex("#e4e4e7");
+var ok = chalk.hex("#34d399");
+var warn = chalk.hex("#fbbf24");
+var err = chalk.hex("#f87171");
+var up = chalk.hex("#22c55e");
+var down = chalk.hex("#ef4444");
+function clawdGradient(text) {
+  const lines = text.split("\n");
+  const shades = [
+    "#22d3ee",
+    "#22d3ee",
+    "#06b6d4",
+    "#0ea5e9",
+    "#3b82f6",
+    "#6366f1",
+    "#8b5cf6",
+    "#a78bfa"
+  ];
+  return lines.map((line, i) => chalk.hex(shades[Math.min(i, shades.length - 1)])(line)).join("\n");
+}
+var dim = chalk.dim;
+var bold = chalk.bold;
+
+// src/render.ts
+var MAX_CELL = 36;
+function renderTable(rows, columns) {
+  if (rows.length === 0) return inkDim("  (no rows)");
+  const cols = columns ?? Object.keys(rows[0]);
+  const widths = {};
+  for (const c of cols) {
+    widths[c] = Math.min(MAX_CELL, Math.max(c.length, ...rows.map((r) => fmtCell(r[c]).length)));
+  }
+  const top = "\u250C" + cols.map((c) => "\u2500".repeat(widths[c] + 2)).join("\u252C") + "\u2510";
+  const mid = "\u251C" + cols.map((c) => "\u2500".repeat(widths[c] + 2)).join("\u253C") + "\u2524";
+  const bot = "\u2514" + cols.map((c) => "\u2500".repeat(widths[c] + 2)).join("\u2534") + "\u2518";
+  const head = "\u2502" + cols.map((c) => ` ${cyanSoft(c.padEnd(widths[c]))} `).join("\u2502") + "\u2502";
+  const body = rows.map(
+    (r) => "\u2502" + cols.map((c) => {
+      const raw = r[c];
+      const v = fmtCell(raw);
+      const truncated = v.length > MAX_CELL;
+      const padded = (truncated ? v.slice(0, MAX_CELL - 1) + "\u2026" : v).padEnd(widths[c]);
+      return ` ${colorize(c, raw, padded)} `;
+    }).join("\u2502") + "\u2502"
+  ).join("\n");
+  return `${ink(top)}
+${head}
+${ink(mid)}
+${body}
+${ink(bot)}`;
+}
+function fmtCell(v) {
+  if (v === null || v === void 0) return "\u2014";
+  if (typeof v === "object") return JSON.stringify(v);
+  return String(v);
+}
+function colorize(col, raw, padded) {
+  if (typeof raw === "number" && /change|24h|delta|pct|%/i.test(col)) {
+    return raw > 0 ? up(padded) : raw < 0 ? down(padded) : marble(padded);
+  }
+  return marble(padded);
+}
+function fmtUsd(n) {
+  if (n === 0) return "$0";
+  const abs = Math.abs(n);
+  if (abs < 1e-4) {
+    const exp = Math.floor(Math.log10(abs));
+    const mantissa = abs / Math.pow(10, exp);
+    return (n < 0 ? "-$" : "$") + mantissa.toFixed(3) + "e" + exp;
+  }
+  if (abs < 1) return (n < 0 ? "-$" : "$") + abs.toFixed(6);
+  if (abs < 100) return (n < 0 ? "-$" : "$") + abs.toFixed(4);
+  if (abs < 1e3) return (n < 0 ? "-$" : "$") + abs.toFixed(2);
+  if (abs < 1e6) return (n < 0 ? "-$" : "$") + (abs / 1e3).toFixed(2) + "K";
+  if (abs < 1e9) return (n < 0 ? "-$" : "$") + (abs / 1e6).toFixed(2) + "M";
+  return (n < 0 ? "-$" : "$") + (abs / 1e9).toFixed(2) + "B";
+}
+function fmtPct(n) {
+  const sign = n > 0 ? "+" : "";
+  return `${sign}${n.toFixed(2)}%`;
+}
+function fmtPctColored(n) {
+  const s = fmtPct(n);
+  return n > 0 ? up(s) : n < 0 ? down(s) : marble(s);
+}
+function fmtAddr(a) {
+  if (!a) return "\u2014";
+  return a.slice(0, 6) + "\u2026" + a.slice(-4);
+}
+var SPARK = ["\u2581", "\u2582", "\u2583", "\u2584", "\u2585", "\u2586", "\u2587", "\u2588"];
+function sparkline(values) {
+  if (values.length === 0) return "";
+  const min = Math.min(...values);
+  const max = Math.max(...values);
+  const range = max - min || 1;
+  return values.map((v) => SPARK[Math.min(7, Math.floor((v - min) / range * 8))]).join("");
+}
+function sectionTitle(title) {
+  return `  ${cyan("\u25B8")} ${bold(marble(title))}`;
+}
+function renderHelp() {
+  const tip = (k, v) => `  ${cyan(k.padEnd(20))} ${ink(v)}`;
+  return [
+    "",
+    `  ${cyanSoft("commands")}`,
+    tip("/price <token>", "token price + 24h + mcap + liquidity"),
+    tip("/wallet <addr>", "ETH balance + top token holdings on Base"),
+    tip("/gas", "current Base gas price + congestion"),
+    tip("/trending", "top trending tokens on Base (volume 24h)"),
+    tip("/new", "newest Base token launches (last 24h)"),
+    tip("/tvl", "Base chain TVL + top protocols"),
+    tip("/scan <addr>", "quick on-chain summary of an address"),
+    tip("/clear", "clear terminal"),
+    tip("/help", "this list"),
+    tip("/exit", "quit (Ctrl+D)"),
+    "",
+    `  ${cyanSoft("natural language")}`,
+    `  ${ink("\u2192 if you set a fal.ai key with /login, anything else is treated")}`,
+    `  ${ink("  as a question and routed to the right command")}`,
+    `  ${dim('  examples: "DEGEN price?", "what is base gas right now"')}`,
+    ""
+  ].join("\n");
+}
+
+// src/commands.ts
+var basePublic = createPublicClient({ chain: base, transport: http() });
+async function cmdPrice(query) {
+  if (!query.trim()) return `  ${err("\u2717")} usage: /price <token-symbol-or-address>`;
+  const r = await fetch(`https://api.dexscreener.com/latest/dex/search?q=${encodeURIComponent(query.trim())}`);
+  if (!r.ok) return `  ${err("\u2717")} dexscreener error: ${r.status}`;
+  const data = await r.json();
+  const pairs = (data.pairs ?? []).filter((p) => p.chainId === "base").sort((a, b) => (b.liquidity?.usd ?? 0) - (a.liquidity?.usd ?? 0)).slice(0, 5);
+  if (pairs.length === 0) {
+    const any = (data.pairs ?? []).slice(0, 3);
+    if (any.length === 0) return `  ${err("\u2717")} no token found matching "${query}"`;
+    return sectionTitle(`No match on Base \u2014 top results across all chains:`) + "\n\n" + renderTable(any.map((p) => pairRow(p)), ["symbol", "chain", "price", "24h", "mcap", "liq", "vol_24h"]);
+  }
+  return sectionTitle(`Base \xB7 "${query}" \u2192 top by liquidity`) + "\n\n" + renderTable(pairs.map((p) => pairRow(p)), ["symbol", "name", "price", "24h", "mcap", "liq", "vol_24h", "address"]);
+}
+function pairRow(p) {
+  const sym = p.baseToken?.symbol ?? "?";
+  const name = p.baseToken?.name?.slice(0, 18) ?? "?";
+  const price = p.priceUsd ? parseFloat(p.priceUsd) : 0;
+  const ch24 = p.priceChange?.h24 ?? 0;
+  const mcap = p.marketCap ?? p.fdv ?? 0;
+  const liq = p.liquidity?.usd ?? 0;
+  const v24 = p.volume?.h24 ?? 0;
+  return {
+    symbol: sym,
+    name,
+    chain: p.chainId,
+    price: fmtUsd(price),
+    "24h": ch24,
+    // raw number → colorized by render
+    mcap: fmtUsd(mcap),
+    liq: fmtUsd(liq),
+    vol_24h: fmtUsd(v24),
+    address: fmtAddr(p.baseToken?.address ?? "")
+  };
+}
+async function cmdWallet(addr) {
+  if (!/^0x[a-fA-F0-9]{40}$/.test(addr.trim())) {
+    return `  ${err("\u2717")} usage: /wallet <0x...>`;
+  }
+  const a = addr.trim();
+  const [bal, code] = await Promise.all([
+    basePublic.getBalance({ address: a }),
+    basePublic.getBytecode({ address: a }).catch(() => void 0)
+  ]);
+  const isContract = !!code && code !== "0x";
+  const out = [
+    "",
+    sectionTitle(`Wallet \xB7 ${fmtAddr(a)}`),
+    `  ${ink("address      ")} ${marble(a)}`,
+    `  ${ink("type         ")} ${isContract ? violet("smart contract") : cyanSoft("EOA")}`,
+    `  ${ink("eth balance  ")} ${marble(formatEther(bal))} ${cyan("ETH")} ${inkDim(`(~${fmtUsd(parseFloat(formatEther(bal)) * 3500)} at ~$3500/ETH)`)}`
+  ];
+  out.push("");
+  out.push(`  ${inkDim("(token holdings coming in v0.2 \u2014 needs Basescan API key)")}`);
+  return out.join("\n");
+}
+async function cmdGas() {
+  const [gasPrice, blockNumber, ethPrice] = await Promise.all([
+    basePublic.getGasPrice(),
+    basePublic.getBlockNumber(),
+    fetchEthPriceUsd()
+  ]);
+  const gwei = Number(gasPrice) / 1e9;
+  const verdict = gwei < 0.05 ? `${ok("calm")} \u2014 basically free` : gwei < 0.5 ? `${ok("normal")} \u2014 comfortable` : gwei < 2 ? `${cyanSoft("busy")} \u2014 pay attention` : `${err("congested")} \u2014 wait a few minutes`;
+  const transferEth = Number(gasPrice) * 21e3 / 1e18;
+  const swapEth = Number(gasPrice) * 15e4 / 1e18;
+  const deployEth = Number(gasPrice) * 15e5 / 1e18;
+  return [
+    "",
+    sectionTitle("Base \xB7 gas"),
+    `  ${ink("gas price   ")} ${marble(gwei.toFixed(6))} ${cyan("gwei")}`,
+    `  ${ink("verdict     ")} ${verdict}`,
+    `  ${ink("block       ")} ${marble("#" + blockNumber.toString())}`,
+    `  ${ink("eth price   ")} ${marble(fmtUsd(ethPrice))}`,
+    "",
+    `  ${ink("cost estimates")}`,
+    `    ${inkDim("ETH transfer  (21k gas)    ")} ${marble(transferEth.toFixed(8) + " ETH")} ${inkDim("\u2248")} ${cyanSoft(fmtUsd(transferEth * ethPrice))}`,
+    `    ${inkDim("Uniswap swap  (150k gas)   ")} ${marble(swapEth.toFixed(8) + " ETH")} ${inkDim("\u2248")} ${cyanSoft(fmtUsd(swapEth * ethPrice))}`,
+    `    ${inkDim("Contract deploy (1.5M gas) ")} ${marble(deployEth.toFixed(8) + " ETH")} ${inkDim("\u2248")} ${cyanSoft(fmtUsd(deployEth * ethPrice))}`,
+    ""
+  ].join("\n");
+}
+async function fetchEthPriceUsd() {
+  try {
+    const r = await fetch("https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd");
+    const d = await r.json();
+    return d.ethereum?.usd ?? 3500;
+  } catch {
+    return 3500;
+  }
+}
+async function cmdTrending() {
+  const r = await fetch(`https://api.dexscreener.com/token-boosts/top/v1`);
+  if (!r.ok) return `  ${err("\u2717")} dexscreener boosts error: ${r.status}`;
+  const data = await r.json();
+  const baseBoosts = data.filter((b) => b.chainId === "base").slice(0, 10);
+  if (baseBoosts.length === 0) return `  ${err("\u2717")} no boosted Base tokens right now`;
+  const enriched = await Promise.all(baseBoosts.map(async (b) => {
+    try {
+      const r2 = await fetch(`https://api.dexscreener.com/latest/dex/tokens/${b.tokenAddress}`);
+      const d2 = await r2.json();
+      const p = (d2.pairs ?? []).filter((p2) => p2.chainId === "base").sort((a, b2) => (b2.liquidity?.usd ?? 0) - (a.liquidity?.usd ?? 0))[0];
+      if (!p) return null;
+      return pairRow(p);
+    } catch {
+      return null;
+    }
+  }));
+  const rows = enriched.filter((x) => !!x);
+  if (rows.length === 0) return `  ${err("\u2717")} no enriched data`;
+  return sectionTitle("Base \xB7 trending (boosted on dexscreener)") + "\n\n" + renderTable(rows, ["symbol", "name", "price", "24h", "mcap", "liq", "vol_24h"]);
+}
+async function cmdNew() {
+  const r = await fetch(`https://api.dexscreener.com/token-profiles/latest/v1`);
+  if (!r.ok) return `  ${err("\u2717")} dexscreener latest error: ${r.status}`;
+  const data = await r.json();
+  const baseLatest = data.filter((t) => t.chainId === "base").slice(0, 10);
+  if (baseLatest.length === 0) return `  ${err("\u2717")} no recent Base profiles`;
+  const rows = await Promise.all(baseLatest.map(async (t) => {
+    try {
+      const r2 = await fetch(`https://api.dexscreener.com/latest/dex/tokens/${t.tokenAddress}`);
+      const d2 = await r2.json();
+      const p = (d2.pairs ?? []).filter((p2) => p2.chainId === "base").sort((a, b) => (b.liquidity?.usd ?? 0) - (a.liquidity?.usd ?? 0))[0];
+      if (!p) return null;
+      return pairRow(p);
+    } catch {
+      return null;
+    }
+  }));
+  const filtered = rows.filter((x) => !!x);
+  return sectionTitle("Base \xB7 newest token profiles") + "\n\n" + renderTable(filtered, ["symbol", "name", "price", "24h", "mcap", "liq", "vol_24h"]);
+}
+async function cmdTvl() {
+  const [hist, protos] = await Promise.all([
+    fetch("https://api.llama.fi/v2/historicalChainTvl/Base").then((r) => r.json()),
+    fetch("https://api.llama.fi/protocols").then((r) => r.json())
+  ]);
+  const recent = hist.slice(-30);
+  const current = recent[recent.length - 1].tvl;
+  const wkAgo = recent[recent.length - 8]?.tvl ?? current;
+  const monAgo = recent[0]?.tvl ?? current;
+  const wkPct = (current - wkAgo) / wkAgo * 100;
+  const monPct = (current - monAgo) / monAgo * 100;
+  const spark = sparkline(recent.map((d) => d.tvl));
+  const baseProtos = protos.filter((p) => p.chainTvls && p.chainTvls["Base"]).sort((a, b) => (b.chainTvls["Base"] ?? 0) - (a.chainTvls["Base"] ?? 0)).slice(0, 10);
+  const out = [
+    "",
+    sectionTitle("Base \xB7 TVL"),
+    `  ${ink("now           ")} ${cyanSoft(fmtUsd(current))}`,
+    `  ${ink("7d change     ")} ${fmtPctColored(wkPct)}`,
+    `  ${ink("30d change    ")} ${fmtPctColored(monPct)}`,
+    `  ${ink("30d trend     ")} ${cyan(spark)}`,
+    "",
+    sectionTitle("Top protocols by Base TVL"),
+    "",
+    renderTable(
+      baseProtos.map((p) => ({
+        protocol: p.name,
+        tvl: fmtUsd(p.chainTvls["Base"])
+      })),
+      ["protocol", "tvl"]
+    )
+  ];
+  return out.join("\n");
+}
+async function cmdScan(addr) {
+  if (!/^0x[a-fA-F0-9]{40}$/.test(addr.trim())) {
+    return `  ${err("\u2717")} usage: /scan <0x...>`;
+  }
+  const a = addr.trim();
+  const [bal, code, txCount] = await Promise.all([
+    basePublic.getBalance({ address: a }),
+    basePublic.getBytecode({ address: a }).catch(() => void 0),
+    basePublic.getTransactionCount({ address: a })
+  ]);
+  const isContract = !!code && code !== "0x";
+  let tokenInfo = null;
+  try {
+    const r = await fetch(`https://api.dexscreener.com/latest/dex/tokens/${a}`);
+    const d = await r.json();
+    const p = (d.pairs ?? []).filter((p2) => p2.chainId === "base").sort((x, y) => (y.liquidity?.usd ?? 0) - (x.liquidity?.usd ?? 0))[0];
+    if (p) {
+      const ch24 = p.priceChange?.h24 ?? 0;
+      tokenInfo = `
+  ${ink("\u2500\u2500\u2500\u2500 token data \u2500\u2500\u2500\u2500")}
+  ${ink("symbol       ")} ${cyan(p.baseToken?.symbol ?? "?")}
+  ${ink("name         ")} ${marble(p.baseToken?.name ?? "?")}
+  ${ink("price        ")} ${cyanSoft(fmtUsd(parseFloat(p.priceUsd ?? "0")))}
+  ${ink("24h          ")} ${fmtPctColored(ch24)}
+  ${ink("mcap         ")} ${marble(fmtUsd(p.marketCap ?? p.fdv ?? 0))}
+  ${ink("liquidity    ")} ${marble(fmtUsd(p.liquidity?.usd ?? 0))}`;
+    }
+  } catch {
+  }
+  return [
+    "",
+    sectionTitle(`Scan \xB7 ${fmtAddr(a)}`),
+    `  ${ink("address      ")} ${marble(a)}`,
+    `  ${ink("type         ")} ${isContract ? violet("smart contract") : cyanSoft("EOA")}`,
+    `  ${ink("eth balance  ")} ${marble(formatEther(bal))} ${cyan("ETH")}`,
+    `  ${ink("tx count     ")} ${marble(txCount.toString())}`,
+    tokenInfo ?? "",
+    "",
+    `  ${inkDim("basescan: https://basescan.org/address/" + a)}`,
+    ""
+  ].join("\n");
+}
+
+// src/llm.ts
+var FAL_URL = "https://fal.run/openrouter/router";
+var MODEL = "anthropic/claude-sonnet-4.5";
+var SYSTEM = `You are an intent classifier for ClawdOS \u2014 a terminal CLI that answers Base blockchain ecosystem questions. Map the user's natural-language request to ONE of these commands:
+
+  price     \u2014 token price / market cap / 24h change lookup
+  wallet    \u2014 show ETH balance and info for a wallet address
+  scan      \u2014 quick on-chain summary of any address (wallet or contract)
+  gas       \u2014 current Base gas price + cost estimates
+  trending  \u2014 top trending Base tokens by volume / boosts
+  new       \u2014 newest token launches on Base in the last 24h
+  tvl       \u2014 Base chain total value locked + top protocols
+  unknown   \u2014 none of the above
+
+Reply with VALID JSON ONLY, no markdown, no commentary:
+
+  {"command": "<one of the above>", "args": "<single argument string, or empty>"}
+
+Argument extraction:
+- For 'price': the token symbol or address (e.g. "DEGEN", "0xabc...")
+- For 'wallet' or 'scan': the 0x... address
+- For 'gas', 'trending', 'new', 'tvl': empty string
+- For 'unknown': empty string
+
+Examples:
+  user: "what is the price of $DEGEN"        \u2192 {"command":"price","args":"DEGEN"}
+  user: "show me wallet 0xabc..."            \u2192 {"command":"wallet","args":"0xabc..."}
+  user: "is gas expensive right now"         \u2192 {"command":"gas","args":""}
+  user: "what just launched on base"         \u2192 {"command":"new","args":""}
+  user: "tvl"                                \u2192 {"command":"tvl","args":""}
+  user: "tell me a joke"                     \u2192 {"command":"unknown","args":""}
+`;
+async function classifyIntent(prompt, falKey) {
+  try {
+    const controller = new AbortController();
+    const t = setTimeout(() => controller.abort(), 8e3);
+    const r = await fetch(FAL_URL, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "authorization": `Key ${falKey}`
+      },
+      body: JSON.stringify({
+        prompt: `${SYSTEM}
+
+User request: ${prompt}
+
+JSON:`,
+        model: MODEL,
+        temperature: 0.1
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(t);
+    if (!r.ok) return { command: "unknown", args: "" };
+    const j = await r.json();
+    const raw = (j.output ?? j.text ?? j.choices?.[0]?.message?.content ?? "").trim();
+    const cleaned = raw.replace(/^```(?:json)?\s*/i, "").replace(/```\s*$/i, "").trim();
+    const parsed = JSON.parse(cleaned);
+    return {
+      command: parsed.command ?? "unknown",
+      args: String(parsed.args ?? "")
+    };
+  } catch {
+    return { command: "unknown", args: "" };
+  }
+}
+
+// src/banner.ts
+var CLAWDOS_ASCII = String.raw`
+  ██████╗ ██╗      █████╗ ██╗    ██╗██████╗  ██████╗ ███████╗
+ ██╔════╝ ██║     ██╔══██╗██║    ██║██╔══██╗██╔═══██╗██╔════╝
+ ██║      ██║     ███████║██║ █╗ ██║██║  ██║██║   ██║███████╗
+ ██║      ██║     ██╔══██║██║███╗██║██║  ██║██║   ██║╚════██║
+ ╚██████╗ ███████╗██║  ██║╚███╔███╔╝██████╔╝╚██████╔╝███████║
+  ╚═════╝ ╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═════╝  ╚═════╝ ╚══════╝
+                                                          ╔═╗
+                                                          ╚═╝  2.0
+`;
+var CLAW = String.raw`
+        ▄▄▄▄▄
+      ▄█▀░░░▀█▄
+     █▀░░▄▄▄░░▀█
+     █░░██████░░█
+     █░░██▀▀██░░█
+      ▀█▄░░░░▄█▀
+        ▀█████▀
+         ▀▀▀
+`;
+function renderBanner(handle) {
+  const w = 64;
+  const sep = ink("\u2500".repeat(w));
+  const ascii = clawdGradient(CLAWDOS_ASCII);
+  const tag = cyanSoft("  the agent OS that watches Base.");
+  const sub = inkDim("  prices \xB7 wallets \xB7 trends \xB7 gas \xB7 tvl \u2014 in your terminal");
+  const status = handle ? `  ${ink("session \xB7")} ${cyan(handle)}` : `  ${ink("session \xB7")} ${dim("guest mode")}`;
+  return `
+${ascii}
+${tag}
+${sub}
+
+${sep}
+${status}
+${sep}
+`;
+}
+function renderMiniHeader(handle, lastMs) {
+  const left = `${cyan("\u25B8 clawd")} ${ink("\xB7")} ${cyanSoft(handle)}`;
+  const right = lastMs !== void 0 ? inkDim(`(${lastMs}ms)`) : "";
+  return `${left} ${right}`;
+}
+
+// src/repl.ts
+async function runRepl(cfg) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const handle = cfg.handle ?? (cfg.wallet ? cfg.wallet.slice(0, 8) + "\u2026" : "guest");
+  rl.setPrompt(`  ${cyan("\u25B8")} `);
+  let lastMs;
+  const printHeader = () => {
+    console.log("");
+    console.log(renderMiniHeader(handle, lastMs));
+  };
+  printHeader();
+  console.log(`  ${inkDim("type")} ${dim("/help")} ${inkDim("for commands, or ask anything in plain english")}`);
+  if (!cfg.fal_key) {
+    console.log(`  ${inkDim("(natural language disabled \u2014 set fal.ai key with")} ${dim("/login <fal-key>")} ${inkDim("to enable)")}`);
+  }
+  rl.prompt();
+  rl.on("line", async (raw) => {
+    const input = raw.trim();
+    if (!input) {
+      rl.prompt();
+      return;
+    }
+    const t0 = Date.now();
+    try {
+      if (input.startsWith("/")) {
+        const handled = await handleSlash(input, cfg);
+        if (handled === "exit") {
+          rl.close();
+          return;
+        }
+        lastMs = Date.now() - t0;
+      } else {
+        if (!cfg.fal_key) {
+          console.log(`  ${err("\u2717")} natural-language disabled \u2014 set fal.ai key first:`);
+          console.log(`     ${dim("/login <your-fal-key>")}`);
+          console.log(`     ${inkDim("get one at https://fal.ai \u2192 Dashboard \u2192 API keys")}`);
+        } else {
+          process.stdout.write(`  ${dim("thinking\u2026")}`);
+          const intent = await classifyIntent(input, cfg.fal_key);
+          process.stdout.write("\r" + " ".repeat(20) + "\r");
+          if (intent.command === "unknown") {
+            console.log(`  ${err("\u2717")} couldn't map that to a command. try /help.`);
+          } else {
+            console.log(`  ${inkDim("\u2192 /")} ${cyanSoft(intent.command)}${intent.args ? " " + cyan(intent.args) : ""}`);
+            await runCommand(intent.command, intent.args);
+            lastMs = Date.now() - t0;
+          }
+        }
+      }
+    } catch (e) {
+      console.log(`  ${err("\u2717")} ${e.message}`);
+    }
+    printHeader();
+    rl.prompt();
+  });
+  rl.on("close", () => {
+    console.log("");
+    console.log(`  ${cyanSoft("ClawdOS goes back to sleep.")}`);
+    process.exit(0);
+  });
+}
+async function handleSlash(input, cfg) {
+  const [rawCmd, ...rest] = input.slice(1).split(" ");
+  const cmd = (rawCmd ?? "").toLowerCase();
+  const arg = rest.join(" ").trim();
+  switch (cmd) {
+    case "help":
+      console.log(renderHelp());
+      return "ok";
+    case "exit":
+    case "quit":
+      return "exit";
+    case "clear":
+      process.stdout.write("\x1Bc");
+      return "ok";
+    case "login": {
+      if (!arg) {
+        console.log(`  ${err("\u2717")} usage: /login <fal-api-key>`);
+        return "ok";
+      }
+      cfg.fal_key = arg;
+      await saveConfig(cfg);
+      console.log(`  ${ok("\u2713")} fal.ai key saved \u2014 natural-language now enabled`);
+      return "ok";
+    }
+    case "logout": {
+      cfg.fal_key = void 0;
+      await saveConfig(cfg);
+      console.log(`  ${ok("\u2713")} fal.ai key removed`);
+      return "ok";
+    }
+    case "whoami": {
+      console.log("");
+      console.log(`  ${ink("session  ")} ${cfg.handle ? cyan(cfg.handle) : dim("guest")}`);
+      console.log(`  ${ink("wallet   ")} ${cfg.wallet ? marble(cfg.wallet) : dim("none set")}`);
+      console.log(`  ${ink("fal key  ")} ${cfg.fal_key ? ok("configured") : dim("not set")}`);
+      console.log("");
+      return "ok";
+    }
+    // The actual commands
+    case "price":
+      await runCommand("price", arg);
+      return "ok";
+    case "wallet":
+      await runCommand("wallet", arg);
+      return "ok";
+    case "scan":
+      await runCommand("scan", arg);
+      return "ok";
+    case "gas":
+      await runCommand("gas", "");
+      return "ok";
+    case "trending":
+      await runCommand("trending", "");
+      return "ok";
+    case "new":
+      await runCommand("new", "");
+      return "ok";
+    case "tvl":
+      await runCommand("tvl", "");
+      return "ok";
+    default:
+      console.log(`  ${err("\u2717")} unknown command: /${cmd}`);
+      console.log(`     ${inkDim("type /help to see all commands")}`);
+      return "ok";
+  }
+}
+async function runCommand(command, arg) {
+  let out = "";
+  process.stdout.write(`  ${dim("fetching\u2026")}`);
+  try {
+    switch (command) {
+      case "price":
+        out = await cmdPrice(arg);
+        break;
+      case "wallet":
+        out = await cmdWallet(arg);
+        break;
+      case "scan":
+        out = await cmdScan(arg);
+        break;
+      case "gas":
+        out = await cmdGas();
+        break;
+      case "trending":
+        out = await cmdTrending();
+        break;
+      case "new":
+        out = await cmdNew();
+        break;
+      case "tvl":
+        out = await cmdTvl();
+        break;
+      default:
+        out = `  ${err("\u2717")} unknown command: ${command}`;
+    }
+  } catch (e) {
+    out = `  ${err("\u2717")} ${e.message}`;
+  }
+  process.stdout.write("\r" + " ".repeat(20) + "\r");
+  console.log(out);
+}
+
+// src/index.ts
+async function main() {
+  const args = process.argv.slice(2);
+  if (args[0] === "--version" || args[0] === "-v") {
+    const pkg = await import("./package-ZJP322TQ.js");
+    console.log(pkg.default.version);
+    return;
+  }
+  if (args[0] === "--help" || args[0] === "-h") {
+    console.log(`
+  clawd \u2014 ClawdOS 2.0 \u2014 the agent OS that watches Base
+
+  USAGE
+    clawd              Start the REPL
+    clawd --version    Print version
+    clawd --help       This help
+
+  INSIDE THE REPL
+    /price <token>     Token price / mcap / 24h
+    /wallet <addr>     Wallet balance + info
+    /gas               Base gas price
+    /trending          Trending Base tokens
+    /new               Newest Base launches
+    /tvl               Base TVL + top protocols
+    /scan <addr>       Quick on-chain summary
+    /login <fal-key>   Enable natural-language
+    /help              Full command list
+
+  DOCS
+    https://clawdos.xyz
+`);
+    return;
+  }
+  let cfg = await loadConfig() ?? {};
+  if (process.env.CLAWDOS_FAL_KEY && !cfg.fal_key) {
+    cfg.fal_key = process.env.CLAWDOS_FAL_KEY;
+    await saveConfig(cfg);
+  }
+  console.log(renderBanner(cfg.handle ?? (cfg.wallet ? cfg.wallet.slice(0, 8) + "\u2026" : void 0)));
+  await runRepl(cfg);
+}
+main().catch((e) => {
+  console.error("\n  fatal:", e.message);
+  process.exit(1);
+});

package/dist/package-ZJP322TQ.js

@@ -0,0 +1,46 @@
+// package.json
+var package_default = {
+  name: "clawdos-cli",
+  version: "0.1.0",
+  description: "ClawdOS 2.0 \u2014 terminal oracle for the Base ecosystem. Token prices, wallet stats, trending launches, gas, TVL \u2014 natural language or slash commands.",
+  type: "module",
+  bin: {
+    clawd: "./dist/index.js"
+  },
+  files: ["dist", "README.md"],
+  scripts: {
+    build: "tsup src/index.ts --format esm --clean --target node20",
+    dev: "bun run src/index.ts",
+    typecheck: "tsc --noEmit"
+  },
+  keywords: [
+    "clawdos",
+    "cli",
+    "base",
+    "ecosystem",
+    "dex",
+    "defi",
+    "token",
+    "wallet",
+    "agent"
+  ],
+  license: "MIT",
+  homepage: "https://clawdos.xyz",
+  repository: {
+    type: "git",
+    url: "https://github.com/clawdos/clawdos-cli.git"
+  },
+  author: "clawdos",
+  dependencies: {
+    chalk: "^5.3.0",
+    viem: "^2.21.0"
+  },
+  devDependencies: {
+    tsup: "^8.0.0",
+    typescript: "^5.6.0",
+    "@types/node": "^22.0.0"
+  }
+};
+export {
+  package_default as default
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "clawdos-cli",
+  "version": "0.1.0",
+  "description": "ClawdOS 2.0 — terminal oracle for the Base ecosystem. Token prices, wallet stats, trending launches, gas, TVL — natural language or slash commands.",
+  "type": "module",
+  "bin": {
+    "clawd": "dist/index.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build":     "tsup src/index.ts --format esm --clean --target node20",
+    "dev":       "bun run src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "clawdos", "cli", "base", "ecosystem", "dex", "defi", "token", "wallet", "agent"
+  ],
+  "license": "MIT",
+  "homepage": "https://clawdos.xyz",
+  "repository": {
+    "type": "git",
+    "url":  "git+https://github.com/clawdos/clawdos-cli.git"
+  },
+  "author": "clawdos",
+  "dependencies": {
+    "chalk":  "^5.3.0",
+    "viem":   "^2.21.0"
+  },
+  "devDependencies": {
+    "tsup":         "^8.0.0",
+    "typescript":   "^5.6.0",
+    "@types/node":  "^22.0.0"
+  }
+}