atlarix 14.52.4 → 15.0.1

package/README.md

@@ -0,0 +1,66 @@
+# Atlarix CLI — an AI coding agent in your terminal
+
+Atlarix is an AI coding agent by [NorahLabs](https://norahlabs.com). The CLI is the same agent
+as the [Atlarix desktop app](https://atlarix.dev), in your terminal: it reads your project,
+plans, edits files with a diff you approve, runs commands in a sandbox, and reviews and debugs
+code. Your sessions, models, API keys, MCP servers and automations are shared with the app.
+
+```sh
+npm i -g atlarix
+atlarix
+```
+
+Other ways to install: `curl -fsSL https://atlarix.dev/install | sh` (macOS, Linux),
+`irm https://atlarix.dev/install.ps1 | iex` (Windows), `brew install amariahak/atlarix/atlarix`,
+or winget. The CLI updates itself.
+
+## What it does
+
+- **Works in any folder.** Run `atlarix` in a project and ask: "fix the failing test",
+  "explain the auth flow", "add a health endpoint".
+- **Five work modes.** Build, Explore, Plan, Debug and Review (shift+tab switches).
+- **Any model.** Atlarix Auto and the Atlarix Core models, your own API key for any provider
+  (OpenAI, Anthropic, Google, DeepSeek, OpenRouter and more), or a local model with Ollama or
+  LM Studio.
+- **Nothing changes without you.** File edits show a diff to approve; shell commands run in a
+  per-OS sandbox.
+- **Sub-agents and background work.** Hand independent tasks to sub-agents; follow and stop
+  background commands from the strip above the prompt box.
+- **Relics.** Ask for a report, plan or design as a shareable page.
+- **Batch mode for CI.** `atlarix run --prompt "…"` runs one task unattended and exits; it is
+  what powers the [Atlarix cloud agent](https://atlarix.dev/cloud-agent) in GitHub Actions.
+
+## Sign in
+
+`atlarix` opens your browser to sign in; `atlarix login --device` signs in from a machine
+without one. Your own API key or a local model works without an Atlarix account.
+
+## FAQ
+
+**What is the Atlarix CLI?** An AI coding agent in your terminal. Run `atlarix` in a project
+folder and it plans, builds, reviews and tests code with you; `atlarix run` does one task
+unattended, for CI and scripts. It is the same agent as the Atlarix desktop app.
+
+**Which models does it work with?** Any: Atlarix Auto (picks the model for each kind of step),
+an Atlarix Core model, your own API key (Anthropic, OpenAI, DeepSeek, OpenRouter and many
+more), or a local model through Ollama or LM Studio.
+
+**Is it free?** Yes. You pay only for Atlarix-hosted models; your own key and local models cost
+nothing on Atlarix's side.
+
+**Does it share anything with the desktop app?** Its sessions, models, API keys, MCP servers and
+automations, so you can start in one and continue in the other.
+
+**Can it work while my computer is off?** That is the [Atlarix cloud agent](https://atlarix.dev/cloud-agent):
+ask from Slack or the web, and it runs in your repository's own GitHub Actions and opens a
+pull request.
+
+## Links
+
+- Product page: https://atlarix.dev/cli
+- Docs: https://atlarix.dev/docs
+- Changelog: https://atlarix.dev/changelog
+- Pricing: https://atlarix.dev/pricing
+- Issues: https://github.com/AmariahAK/atlarix-releases/issues
+
+Atlarix is proprietary software by NorahLabs (Nairobi, Kenya).

package/bin/atlarix.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+/**
+ * `atlarix` from npm. Runs this platform's compiled CLI — the interactive
+ * terminal app, the same binary as the curl / Homebrew / winget installs — from
+ * its `atlarix-<os>-<arch>` package (an optional dependency, so npm installs
+ * only the one that fits).
+ *
+ * With no matching package (an unusual platform, or `--no-optional`), it runs
+ * the bundled Node build instead: the batch agent (`atlarix run …`) that CI,
+ * the cloud agent and benchmarks use. So `npx atlarix run …` works everywhere.
+ */
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const require = createRequire(import.meta.url);
+
+function isMusl() {
+  if (process.platform !== "linux") return false;
+  try {
+    return !process.report?.getReport()?.header?.glibcVersionRuntime;
+  } catch {
+    return false;
+  }
+}
+
+const os = process.platform === "win32" ? "windows" : process.platform;
+const name = `atlarix-${os}-${process.arch}${isMusl() ? "-musl" : ""}`;
+const exe = process.platform === "win32" ? "atlarix.exe" : "atlarix";
+
+let binary = null;
+try {
+  binary = require.resolve(`${name}/bin/${exe}`);
+} catch {
+  /* not installed for this platform */
+}
+
+if (binary) {
+  const r = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+  if (r.error) {
+    console.error(`atlarix: could not start ${binary}: ${r.error.message}`);
+    process.exit(1);
+  }
+  if (r.signal) process.kill(process.pid, r.signal);
+  process.exit(r.status ?? 1);
+}
+
+const batch = process.argv.slice(2).some((a) => a === "run" || a.startsWith("--prompt") || a === "--version" || a === "-v");
+if (!batch) {
+  console.error(
+    `atlarix: the interactive CLI isn't installed for ${os}-${process.arch} (package ${name}).\n` +
+      "Install it from https://atlarix.dev/install, or reinstall without --no-optional.\n" +
+      "Scripts and CI can still use `atlarix run --prompt …`.",
+  );
+  process.exit(1);
+}
+// The Node build needs better-sqlite3, which is NOT a dependency of this
+// package: every platform with a prebuilt CLI (all seven we publish) never
+// reaches this line, and carrying it cost everyone 40 packages and a native
+// download on `npm install -g atlarix` (2026-10-04). The rare platform without
+// one installs it beside atlarix, where Node's lookup finds it.
+try {
+  require.resolve("better-sqlite3");
+} catch {
+  console.error(
+    `atlarix: no prebuilt CLI for ${os}-${process.arch}, and the Node fallback needs better-sqlite3.\n` +
+      "Install it beside atlarix: npm install -g better-sqlite3",
+  );
+  process.exit(1);
+}
+await import(path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "dist-headless", "atlarix-headless.mjs"));

package/dist-headless/AGENTS.md

@@ -47,6 +47,10 @@ Atlarix renders these inline as collapsible cards — put the visual in the same
 - **Graph** — ` ```graph ` fence: `{ "title"?: string, "nodes": [{ "id", "name" }], "edges": [{ "source", "target" }] }` for flows / architecture / dependencies (edge ids must exist on nodes; no coordinates).
 - **Markmap** — ` ```markmap ` fence: markdown headings + bullets with one root `#` title, for hierarchies / outlines.
 
+## Relics
+
+A **relic** (the `relic` tool) is a self-contained web page to SHARE, not a file of the project: a design to agree on before building, an explainer, a report. Reach for one when a page shows it better than chat does; one relic per thing, updated in place with its `id`. Tell the user the link or path it returns. Never put secrets in one.
+
 ## Browsers
 
 - `browser` and `browser_inspect` drive the user's own browser (Chrome, Edge or Brave) through the Atlarix extension, in Atlarix's own tab group — never the tab the user is on. Open the app you are building at its localhost dev-server URL there, act, then check `browser_inspect` mode:"console" (it shows entries since your last navigate) to confirm nothing threw.