papiers 0.0.1 → 0.1.1

package/README.md

@@ -0,0 +1,38 @@
+# Papiers CLI
+
+Search and read your Papiers library from the terminal.
+
+## Install
+
+```bash
+npm install -g papiers
+```
+
+Requires Node.js 22 or newer.
+
+## Sign in
+
+In Papiers, open Settings -> API tokens, create a token, then sign in:
+
+```bash
+papiers auth login --token-stdin
+```
+
+Paste the token when prompted. The CLI saves it locally so you do not need to
+paste it again.
+
+## Common Commands
+
+```bash
+papiers capabilities
+papiers list --kind document --limit 5
+papiers search "retrieval augmented generation" --limit 10
+papiers read doc_... --format markdown
+```
+
+Use `--json` for stable machine-readable output. Use `--ids`, `--ids0`, and
+`--doc-ids` to pipe results between commands.
+
+## Automation
+
+For CI or scripts, set `PAPIERS_TOKEN` and pass `--json` for stable machine-readable output.

package/bin/papiers.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const entrypointPath = join(
+  dirname(fileURLToPath(import.meta.url)),
+  "../dist/index.js",
+);
+
+if (!existsSync(entrypointPath)) {
+  process.stderr.write(
+    "Papiers CLI could not start because its entrypoint is missing. Reinstall the papiers package and try again.\n",
+  );
+  process.exitCode = 1;
+} else {
+  const result = spawnSync(
+    process.execPath,
+    [entrypointPath, ...process.argv.slice(2)],
+    {
+      stdio: "inherit",
+      env: process.env,
+    },
+  );
+
+  if (result.error) {
+    process.stderr.write(`${result.error.message}\n`);
+    process.exitCode = 1;
+  } else if (result.signal) {
+    process.stderr.write(`papiers exited after signal ${result.signal}\n`);
+    process.exitCode = 1;
+  } else {
+    process.exitCode = result.status ?? 0;
+  }
+}