@clutor/cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sagar Pinninti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# @clutor/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The `clutor` command and local server.
+
+```bash
+npm install -g @clutor/cli
+clutor plan deepseek-v3 --ram 16     # will it fit, and how fast could it possibly go
+clutor plan ./my-model.gguf          # exact figures from a real file
+clutor serve                         # OpenAI- and Ollama-compatible API on 127.0.0.1:4320, agent, MCP
+clutor code "fix the failing test" --verify "npm test"
+```
+
+Run `clutor --help`. Documentation: <https://github.com/isagarpinninti/clutor/blob/main/docs/GUIDE.md>.
+
+It does not run models itself; it supervises [llama.cpp](https://github.com/ggml-org/llama.cpp)'s `llama-server` or talks to any OpenAI-compatible server.

package/dist/bin.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import {
+  main
+} from "./chunk-6WAEQCCP.js";
+import "./chunk-U5GHVJJO.js";
+
+// src/bin.ts
+import { mkdirSync, readFileSync, appendFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { createInterface } from "readline";
+var rl;
+var historyFile = join(homedir(), ".clutor", "history");
+function readline() {
+  if (rl) return rl;
+  let history = [];
+  try {
+    history = readFileSync(historyFile, "utf8").split("\n").filter(Boolean).slice(-500).reverse();
+  } catch {
+  }
+  rl = createInterface({ input: process.stdin, output: process.stderr, history, historySize: 500 });
+  return rl;
+}
+var prompt = (q) => new Promise((resolve) => {
+  const r = readline();
+  const onClose = () => resolve("/exit");
+  r.once("close", onClose);
+  r.question(q, (a) => {
+    r.off("close", onClose);
+    if (a.trim()) {
+      try {
+        mkdirSync(join(homedir(), ".clutor"), { recursive: true, mode: 448 });
+        appendFileSync(historyFile, `${a.replace(/\n/g, " ")}
+`, { mode: 384 });
+      } catch {
+      }
+    }
+    resolve(a);
+  });
+});
+main(process.argv.slice(2), {
+  out: (l) => console.log(l),
+  err: (l) => console.error(l),
+  cwd: process.cwd(),
+  ...process.stdin.isTTY ? { prompt } : {}
+}).then(
+  (code) => process.exit(code),
+  (e) => {
+    console.error(e instanceof Error ? e.message : String(e));
+    process.exit(1);
+  }
+);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { mkdirSync, readFileSync, appendFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { createInterface, type Interface } from \"node:readline\";\nimport { main } from \"./cli\";\n\n// One readline interface for the whole process, so arrow-key history works across prompts and Ctrl-D ends an interactive session.\nlet rl: Interface | undefined;\nconst historyFile = join(homedir(), \".clutor\", \"history\");\nfunction readline(): Interface {\n  if (rl) return rl;\n  let history: string[] = [];\n  try { history = readFileSync(historyFile, \"utf8\").split(\"\\n\").filter(Boolean).slice(-500).reverse(); } catch { /* no history yet */ }\n  rl = createInterface({ input: process.stdin, output: process.stderr, history, historySize: 500 });\n  return rl;\n}\nconst prompt = (q: string): Promise<string> => new Promise((resolve) => {\n  const r = readline();\n  const onClose = (): void => resolve(\"/exit\");\n  r.once(\"close\", onClose);\n  r.question(q, (a) => {\n    r.off(\"close\", onClose);\n    if (a.trim()) { try { mkdirSync(join(homedir(), \".clutor\"), { recursive: true, mode: 0o700 }); appendFileSync(historyFile, `${a.replace(/\\n/g, \" \")}\\n`, { mode: 0o600 }); } catch { /* history is a convenience */ } }\n    resolve(a);\n  });\n});\n\nmain(process.argv.slice(2), {\n  out: (l) => console.log(l),\n  err: (l) => console.error(l),\n  cwd: process.cwd(),\n  ...(process.stdin.isTTY ? { prompt } : {}),\n}).then(\n  (code) => process.exit(code),\n  (e: unknown) => {\n    console.error(e instanceof Error ? e.message : String(e));\n    process.exit(1);\n  },\n);\n"],"mappings":";;;;;;;AACA,SAAS,WAAW,cAAc,sBAAsB;AACxD,SAAS,eAAe;AACxB,SAAS,YAAY;AACrB,SAAS,uBAAuC;AAIhD,IAAI;AACJ,IAAM,cAAc,KAAK,QAAQ,GAAG,WAAW,SAAS;AACxD,SAAS,WAAsB;AAC7B,MAAI,GAAI,QAAO;AACf,MAAI,UAAoB,CAAC;AACzB,MAAI;AAAE,cAAU,aAAa,aAAa,MAAM,EAAE,MAAM,IAAI,EAAE,OAAO,OAAO,EAAE,MAAM,IAAI,EAAE,QAAQ;AAAA,EAAG,QAAQ;AAAA,EAAuB;AACpI,OAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,QAAQ,SAAS,aAAa,IAAI,CAAC;AAChG,SAAO;AACT;AACA,IAAM,SAAS,CAAC,MAA+B,IAAI,QAAQ,CAAC,YAAY;AACtE,QAAM,IAAI,SAAS;AACnB,QAAM,UAAU,MAAY,QAAQ,OAAO;AAC3C,IAAE,KAAK,SAAS,OAAO;AACvB,IAAE,SAAS,GAAG,CAAC,MAAM;AACnB,MAAE,IAAI,SAAS,OAAO;AACtB,QAAI,EAAE,KAAK,GAAG;AAAE,UAAI;AAAE,kBAAU,KAAK,QAAQ,GAAG,SAAS,GAAG,EAAE,WAAW,MAAM,MAAM,IAAM,CAAC;AAAG,uBAAe,aAAa,GAAG,EAAE,QAAQ,OAAO,GAAG,CAAC;AAAA,GAAM,EAAE,MAAM,IAAM,CAAC;AAAA,MAAG,QAAQ;AAAA,MAAiC;AAAA,IAAE;AACtN,YAAQ,CAAC;AAAA,EACX,CAAC;AACH,CAAC;AAED,KAAK,QAAQ,KAAK,MAAM,CAAC,GAAG;AAAA,EAC1B,KAAK,CAAC,MAAM,QAAQ,IAAI,CAAC;AAAA,EACzB,KAAK,CAAC,MAAM,QAAQ,MAAM,CAAC;AAAA,EAC3B,KAAK,QAAQ,IAAI;AAAA,EACjB,GAAI,QAAQ,MAAM,QAAQ,EAAE,OAAO,IAAI,CAAC;AAC1C,CAAC,EAAE;AAAA,EACD,CAAC,SAAS,QAAQ,KAAK,IAAI;AAAA,EAC3B,CAAC,MAAe;AACd,YAAQ,MAAM,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,CAAC;AACxD,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}