@novaqore/atom 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NovaQore LLC
+
+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

@@ -0,0 +1,42 @@
+# Atom
+
+Atom is a server agent. It runs on the box it operates, with shell access at the system level and full awareness of its environment: platform, runtime, shell, and working directory. Use it where you want an autonomous agent that reads, writes, and executes across the whole server, not just inside a project folder.
+
+> [!WARNING]
+> Atom is not intended for personal machines. It runs with shell access at the system level by design. Only use it in isolated environments such as AWS EC2 instances, DigitalOcean droplets, GCP VMs, Hetzner servers, Linode boxes, or Fly.io machines.
+
+> Status: experimental (`v0.0.1`). The CLI scaffold is in place; the agent core is being built next.
+
+## Install
+
+```bash
+npm install -g @novaqore/atom
+```
+
+This installs the `atom` command globally.
+
+## Get your keys
+
+Atom runs on the NovaQore AI service. You will need an account and a Quantum Key before you can use the agent.
+
+1. Sign up at [novaqore.ai](https://novaqore.ai).
+2. Generate a UID, Key ID, and Quantum Key at [chat.novaqore.ai/keys](https://chat.novaqore.ai/keys).
+3. Keep them somewhere safe. Atom asks for them on first run.
+
+## Quick start
+
+Once installed, run it from any directory:
+
+```bash
+atom
+```
+
+The first run walks you through onboarding and asks for your UID, Key ID, and Quantum Key. They are stored locally in `~/.atom/` and only sent to the NovaQore AI service when you chat.
+
+## Requirements
+
+- Node.js 20 or higher
+
+## License
+
+MIT © NovaQore LLC. See [LICENSE](LICENSE).

package/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import "./src/setup.js";
+import { run } from "./src/cli.js";
+
+run(process.argv).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@novaqore/atom",
+  "version": "0.0.1",
+  "description": "A full-system code agent with root-level access, built for isolated servers.",
+  "type": "module",
+  "bin": {
+    "atom": "./index.js"
+  },
+  "main": "./index.js",
+  "files": [
+    "index.js",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/novaqore/atom.git"
+  },
+  "bugs": {
+    "url": "https://github.com/novaqore/atom/issues"
+  },
+  "homepage": "https://github.com/novaqore/atom#readme",
+  "author": "NovaQore LLC",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@novaqore/ai": "^0.5.0",
+    "commander": "^14.0.3",
+    "ink": "^6.8.0",
+    "ink-select-input": "^6.2.0",
+    "ink-text-input": "^6.0.0",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "react": "^19.2.6"
+  }
+}

package/src/app.js

@@ -0,0 +1,73 @@
+import React, { useState } from "react";
+import { accessSync } from "node:fs";
+import { unlink } from "node:fs/promises";
+import { OnboardingScreen } from "./screens/onboarding.js";
+import { MainMenuScreen } from "./screens/main-menu.js";
+import { ChatScreen } from "./screens/chat.js";
+import { SystemScreen } from "./screens/system.js";
+import { UnhingedWarningScreen } from "./screens/unhinged-warning.js";
+import { SERVICE_FILE } from "./utils/paths.js";
+
+function hasOnboardedSync() {
+  try {
+    accessSync(SERVICE_FILE);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function App({ version, unhinged }) {
+  const [onboarded, setOnboarded] = useState(hasOnboardedSync);
+  const [unhingedConfirmed, setUnhingedConfirmed] = useState(!unhinged);
+  const [screen, setScreen] = useState(() =>
+    unhinged && !unhingedConfirmed ? "unhinged-warning" : "main-menu"
+  );
+
+  const handleReset = async () => {
+    await unlink(SERVICE_FILE).catch(() => {});
+    setOnboarded(false);
+  };
+
+  if (screen === "unhinged-warning") {
+    return React.createElement(UnhingedWarningScreen, {
+      onConfirm: () => {
+        setUnhingedConfirmed(true);
+        setScreen("main-menu");
+      },
+    });
+  }
+  if (screen === "main-menu") {
+    return React.createElement(MainMenuScreen, {
+      version,
+      unhinged,
+      onboarded,
+      onChat: () => setScreen("chat"),
+      onGetStarted: () => setScreen("onboarding"),
+      onSystem: () => setScreen("system"),
+      onReset: handleReset,
+    });
+  }
+  if (screen === "onboarding") {
+    return React.createElement(OnboardingScreen, {
+      version,
+      unhinged,
+      onComplete: () => {
+        setOnboarded(true);
+        setScreen("main-menu");
+      },
+      onBack: () => setScreen("main-menu"),
+    });
+  }
+  if (screen === "chat") {
+    return React.createElement(ChatScreen, { version, unhinged });
+  }
+  if (screen === "system") {
+    return React.createElement(SystemScreen, {
+      version,
+      unhinged,
+      onBack: () => setScreen("main-menu"),
+    });
+  }
+  return null;
+}

package/src/cli.js

@@ -0,0 +1,45 @@
+import { mkdir, readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { render } from "ink";
+import React from "react";
+import { App } from "./app.js";
+import { ATOM_DIR } from "./utils/paths.js";
+
+async function readPackageVersion() {
+  const pkgUrl = new URL("../package.json", import.meta.url);
+  const raw = await readFile(fileURLToPath(pkgUrl), "utf8");
+  return JSON.parse(raw).version;
+}
+
+export async function run(argv) {
+  const version = await readPackageVersion();
+  const program = new Command();
+
+  program
+    .name("atom")
+    .description(
+      "A full-system code agent with root-level access, built for isolated servers."
+    )
+    .version(version, "-v, --version", "Output the current version")
+    .option("--unhinged", "Bypass confirmation for dangerous commands")
+    .addHelpText(
+      "after",
+      `
+Examples:
+  $ atom             Start Atom
+  $ atom --unhinged  Start Atom with no command guardrails
+  $ atom -v          Print the current version
+
+Learn more: https://github.com/novaqore/atom`
+    )
+    .action(async (opts) => {
+      await mkdir(ATOM_DIR, { recursive: true, mode: 0o700 });
+      process.stdout.write("\x1Bc");
+      render(
+        React.createElement(App, { version, unhinged: !!opts.unhinged })
+      );
+    });
+
+  await program.parseAsync(argv);
+}

package/src/components/Chat/ChatInput.js

@@ -0,0 +1,84 @@
+import React, { useState, useEffect } from "react";
+import { homedir } from "node:os";
+import { Box, Text } from "ink";
+import TextInput from "ink-text-input";
+import { HOSTNAME, USERNAME } from "../../utils/system.js";
+
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const CONTEXT_TOTAL = 262144;
+
+function Spinner() {
+  const [i, setI] = useState(0);
+  useEffect(() => {
+    const id = setInterval(
+      () => setI((n) => (n + 1) % SPINNER_FRAMES.length),
+      80
+    );
+    return () => clearInterval(id);
+  }, []);
+  return React.createElement(Text, { color: "cyan" }, SPINNER_FRAMES[i]);
+}
+
+function shortPath(p) {
+  const home = homedir();
+  if (p === home) return "~";
+  if (p.startsWith(home + "/")) return "~" + p.slice(home.length);
+  return p;
+}
+
+export function ChatInput({
+  value,
+  onChange,
+  onSubmit,
+  cwd,
+  totalTokens,
+  loading,
+  disabled,
+}) {
+  return React.createElement(
+    Box,
+    { flexDirection: "column" },
+    loading
+      ? React.createElement(
+          Box,
+          null,
+          React.createElement(Spinner),
+          React.createElement(Text, { dimColor: true }, " Responding...")
+        )
+      : null,
+    React.createElement(
+      Box,
+      null,
+      React.createElement(
+        Text,
+        { color: "white" },
+        `${USERNAME}@${HOSTNAME} `
+      ),
+      React.createElement(Text, { color: "yellow" }, shortPath(cwd)),
+      React.createElement(
+        Text,
+        { dimColor: true },
+        `  ${totalTokens.toLocaleString()}/${CONTEXT_TOTAL.toLocaleString()} tokens`
+      )
+    ),
+    React.createElement(
+      Box,
+      {
+        borderStyle: "single",
+        borderTop: true,
+        borderBottom: true,
+        borderLeft: false,
+        borderRight: false,
+        borderColor: "gray",
+      },
+      React.createElement(Text, { dimColor: true }, "❯ "),
+      React.createElement(TextInput, {
+        value,
+        onChange,
+        onSubmit,
+        showCursor: !disabled,
+        focus: !disabled,
+      })
+    )
+  );
+}

package/src/components/Chat/ConfirmDangerousCommand.js

@@ -0,0 +1,46 @@
+import React from "react";
+import { Box, Text } from "ink";
+import SelectInput from "ink-select-input";
+
+const items = [
+  { label: "Yes", value: true },
+  { label: "No", value: false },
+];
+
+function YellowIndicator({ isSelected }) {
+  return React.createElement(
+    Box,
+    { marginRight: 1 },
+    isSelected
+      ? React.createElement(Text, { color: "yellow" }, "❯")
+      : React.createElement(Text, null, " ")
+  );
+}
+
+function YellowItem({ isSelected, label }) {
+  return React.createElement(
+    Text,
+    isSelected ? { color: "yellow" } : null,
+    label
+  );
+}
+
+export function ConfirmDangerousCommand({ command, onAnswer }) {
+  return React.createElement(
+    Box,
+    {
+      flexDirection: "column",
+      borderStyle: "single",
+      borderColor: "red",
+      borderLeft: false,
+      borderRight: false,
+    },
+    React.createElement(Text, { color: "red", bold: true }, `Run: ${command}`),
+    React.createElement(SelectInput, {
+      items,
+      onSelect: (item) => onAnswer(item.value),
+      indicatorComponent: YellowIndicator,
+      itemComponent: YellowItem,
+    })
+  );
+}

package/src/components/Header.js

@@ -0,0 +1,64 @@
+import React from "react";
+import { arch, cpus, totalmem } from "node:os";
+import { Box, Text } from "ink";
+import { DISK } from "../utils/system.js";
+import { RUNTIMES } from "../utils/runtimes.js";
+
+export function Header({ version, unhinged }) {
+  const cpuList = cpus();
+  const cpuCount = cpuList?.length || 0;
+  const cpuSpeed = cpuList?.[0]?.speed || 0;
+  const cpuInfo = cpuSpeed
+    ? `${cpuCount}c @ ${(cpuSpeed / 1000).toFixed(2)} GHz`
+    : `${cpuCount} cores`;
+  const ramInfo = `${(totalmem() / 1024 ** 3).toFixed(1)} GB`;
+  const diskInfo = DISK
+    ? `${(DISK.used / 1024 ** 3).toFixed(0)}/${(DISK.total / 1024 ** 3).toFixed(0)} GB`
+    : null;
+
+  const runtimeParts = [arch(), `node ${RUNTIMES.node}`];
+  if (RUNTIMES.python !== "not installed") {
+    runtimeParts.push(`python ${RUNTIMES.python}`);
+  }
+
+  const hardwareParts = [cpuInfo, ramInfo];
+  if (diskInfo) hardwareParts.push(diskInfo);
+
+  return React.createElement(
+    Box,
+    {
+      borderStyle: "round",
+      borderColor: "cyan",
+      paddingX: 2,
+      marginBottom: 1,
+    },
+    React.createElement(
+      Box,
+      { flexDirection: "column", marginRight: 2 },
+      React.createElement(Text, { color: "cyan", bold: true }, " ╲│╱ "),
+      React.createElement(Text, { color: "cyan", bold: true }, "─ ● ─"),
+      React.createElement(Text, { color: "cyan", bold: true }, " ╱│╲ ")
+    ),
+    React.createElement(
+      Box,
+      { flexDirection: "column" },
+      React.createElement(
+        Box,
+        null,
+        React.createElement(Text, { color: "cyan", bold: true }, "Atom "),
+        React.createElement(Text, { dimColor: true }, `v${version}  ·  `),
+        React.createElement(Text, { color: "white", bold: true }, "NovaQore"),
+        React.createElement(Text, { dimColor: true }, "  ·  mode: "),
+        React.createElement(
+          Text,
+          unhinged
+            ? { color: "red", bold: true }
+            : { color: "green", bold: true },
+          unhinged ? "unhinged" : "normal"
+        )
+      ),
+      React.createElement(Text, { dimColor: true }, runtimeParts.join(" · ")),
+      React.createElement(Text, { dimColor: true }, hardwareParts.join(" · "))
+    )
+  );
+}