auramaxx 0.0.19 → 0.1.0

package/README.md

@@ -1,84 +1,104 @@
-# AURAMAXX.SH 🗿🖤
+# AuraJS
 
-**The open-source Apple Keychain for your agent. Securely share passwords, API keys, and credit cards with any AI agents.**
+Write JavaScript 2D and 3D games, compile to native.
+Create, play, and publish from your terminal.
 
-![AuraMaxx](./public/README.png)
+> Alpha status: AuraJS is still in alpha and not ready for production use.
 
-[X](https://x.com/npxauramaxx) · [Website](https://auramaxx.sh) · [Docs](https://auramaxx.sh/docs) · [Help](https://x.com/nicoletteduclar) · [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+![AuraJS](https://aurajs.gg/og.webp)
 
-## Features
-
-**FAST.** Your keys never leave your machine. Everything is stored and runs locally.
-
-**SECURE.** Model providers never see your secrets in plain text. Agents get scoped tokens, not raw credentials.
-
-**CONTROL.** Fine-grained control over what each agent can do. Permission scopes, per-token limits, and human approval for every sensitive action.
-
-**Set up once, use everywhere.** Works across Claude Code, Cursor, Codex, OpenClaw, and any MCP and Skills compatible agent.
+Website: [aurajs.gg](https://aurajs.gg)
 
 ## Quickstart
 
 ```bash
 npm install -g auramaxx
-auramaxx
-auramaxx status
-
-# or quickstart
-npx auramaxx
+auramaxx create my-game
+cd my-game
+npm run dev
 ```
 
-Open `http://localhost:4747`, create/unlock your agent, then add your first credential.
-
-## Get Your First Secret
-
-Make sure you set up your agent first.
+One-off bootstrap without a global install:
 
 ```bash
-auramaxx get OURSECRET
-
-# if auramaxx command is not found, open a new terminal or run:
-source ~/.zshrc  # or source ~/.bashrc
-
-# or use npx directly
-npx auramaxx get OURSECRET
+npx auramaxx
 ```
 
-Agent verify prompt:
-
-`Use auramaxx skill to get OURSECRET.`
-
-## Agent Setup
+Inside a scaffolded game, use the shorter `auramaxx` alias or the generated
+`npm run ...` scripts for local engine commands.
 
-**Skills** (OpenClaw, Claude Code, Codex CLI):
+Play an example:
 
 ```bash
-# set up globally for common agents
-npx -y auramaxx skill
+auramaxx play aurasu
 
-cd <your-codebase-or-workspace>
-npx -y skills add Aura-Industry/auramaxx
+# or run a published game wrapper directly
+npx aurasu play
 ```
 
-**MCP** (Codex, Claude Desktop, Cursor IDE) — add to your client's MCP config:
-
-```json
-{
-  "mcpServers": {
-    "auramaxx": {
-      "command": "npx",
-      "args": ["auramaxx", "mcp"]
-    }
-  }
-}
-```
-
-## Further Reading
+## Multiplayer TL;DR
 
-- [Docs](/docs) — full documentation
-- [Agent Setup](./docs/quickstart/AGENT_SETUP.md) — per-client setup details
-- [Security](./docs/why-auramaxx/security.md) — how keys and tokens work
-- [Troubleshooting](./docs/how-to-auramaxx/TROUBLESHOOTING.md)
+```bash
+auramaxx create my-room-game --template multiplayer
+cd my-room-game
+npm run dev
 
-## Questions / Support
+# second terminal
+npm run join -- AURA2P
+```
 
-https://x.com/nicoletteduclar
+Keep that same flow and add internet-backed rooms with either:
+
+- `aura.config.json -> multiplayer.relay = "relay.aurajs.gg"`
+- or `AURA_MULTIPLAYER_RELAY_HOST=relay.aurajs.gg`
+
+Use [`packages/aurascript/docs/external/game-dev-api/multiplayer-quickstart.md`](./packages/aurascript/docs/external/game-dev-api/multiplayer-quickstart.md) for the short multiplayer doc, or [`packages/aurascript/examples/multiplayer-party/README.md`](./packages/aurascript/examples/multiplayer-party/README.md) for the same-project example with diagnostics and room chat.
+
+## Feature Set
+
+| Metric | AuraJS | Unity | C / C++ | Electron |
+|---|---|---|---|---|
+| Engine fees | **free** | paid tiers | none | free |
+| Hot reload | **<1s** | 5-30s | recompile | <1s |
+| Min binary size | **~2 MB** | ~80 MB | ~1 MB | ~150 MB |
+| GPU access | **native** | native | native | WebGL |
+| Developer pool | **20M+** | 5M | 3M | 20M+ |
+| AI code gen quality | **excellent** | decent | poor | decent |
+| Multiplayer | **sync JSON** | Netcode | custom | sync JSON |
+| Modding | **native** | framework | Lua/etc | native |
+| Patch size | **KBs** | MBs-GBs | full binary | KBs |
+| Platform APIs | **built in** | - | - | - |
+| Vendor lock-in | **none** | heavy | none | Chromium |
+| Build config | **zero** | editor | cmake | webpack |
+
+- JavaScript-first authoring with a native Rust host underneath it
+- Terminal-first create, dev, play, inspect, and publish flow through `auramaxx`
+- Native host binaries for macOS, Linux, and Windows
+- Room-code multiplayer with local-first join, internet promotion, and relay fallback
+- Public docs, handbook pages, and exact contract references on `aurajs.gg/docs`
+- Publishable npm game wrappers that can be played from the terminal
+
+## Docs
+
+- [`packages/aurascript/README.md`](./packages/aurascript/README.md) - AuraJS overview and public docs entrypoint
+- [`docs/external/game-dev-api/README.md`](./docs/external/game-dev-api/README.md) - game developer handbook
+- [`docs/external/game-dev-api/multiplayer-quickstart.md`](./packages/aurascript/docs/external/game-dev-api/multiplayer-quickstart.md) - shortest multiplayer setup path
+- [`docs/api-contract.md`](./docs/api-contract.md) - frozen core API contract
+- [`docs/api-contract-3d.md`](./docs/api-contract-3d.md) - frozen 3D API contract
+- [`docs/reference/README.md`](./docs/reference/README.md) - exact reference index
+- [`docs/external/api-contract-complete.md`](./docs/external/api-contract-complete.md) - combined public reference
+
+Live docs:
+
+- <https://aurajs.gg/docs>
+- <https://aurajs.gg/docs/handbook>
+- <https://aurajs.gg/docs/reference>
+
+## Native Host Binary Packages
+
+| Platform | Package |
+|----------|---------|
+| macOS ARM | [`@aurajs/darwin-arm64`](https://github.com/Aura-Industry/aurajs-darwin-arm64) |
+| macOS x64 | [`@aurajs/darwin-x64`](https://github.com/Aura-Industry/aurajs-darwin-x64) |
+| Linux x64 | [`@aurajs/linux-x64`](https://github.com/Aura-Industry/aurajs-linux-x64) |
+| Windows x64 | [`@aurajs/win32-x64`](https://github.com/Aura-Industry/aurajs-win32-x64) |

package/bin/auramaxx.js

@@ -33,11 +33,9 @@ const COMMANDS = {
   restore: 'Restore from a backup (--list, --latest, --dry-run)',
   api: 'Call any wallet API endpoint from CLI (auth + JSON wrapper)',
   auth: 'Request/poll agent auth approvals from CLI',
-  diary: 'Append daily diary entries via authenticated CLI path',
   'register-agent': 'Create/register a subsequent local agent (non-primary)',
   actions: 'Create/list/resolve human actions and manage action tokens',
   approve: 'Approve a pending human action by ID (admin only)',
-  apikey: 'List/validate/set/delete API keys',
   app: 'Manage installed apps (install, remove, list, update)',
   mcp: 'Start MCP server (stdio) for Claude Code, Cursor, etc.',
   cron: 'Run the cron server standalone (balance sync, price sync)',
@@ -45,39 +43,46 @@ const COMMANDS = {
   skill: 'Install AuraMaxx skills for Claude/Codex/OpenClaw and run install doctor',
   wallet: 'Wallet API wrappers (status, assets, transactions, swap, send, fund, launch)',
   // social: 'Social API wrappers (register, unregister, post, feed, follow, notifications, status)', // Temporarily disabled at root CLI.
-  quickhack: 'Generate random tutorial secret, run set+inject, and print copyable commands',
-  agent: 'Retrieve/manage credentials (get, set, share via secret gist, delete, list)',
   service: 'Manage background service (install, uninstall, status)',
-  secret: 'Run commands with injected secret env vars (inject)',
   token: 'Preview profile-based token policy before issuance',
-  env: 'Load env vars from agent via .aura file (run, inject, check, list, init)',
   'shell-hook': 'Auto-load .aura env vars on cd (like direnv)',
   play: 'Play an AuraJS game from npm (auramaxx play <game>)',
-  create: 'Scaffold a new AuraJS game project ready for npm publish',
+  fork: 'Fork a published AuraJS game into a local editable project (auramaxx fork <game>)',
+  create: 'Scaffold a new AuraJS game (2d/3d/blank) via AuraJS CLI',
+  make: 'Generate authored AuraJS project files via AuraJS CLI',
+  publish: 'Publish current AuraJS game package to npm with guided prompts',
+  // diary: 'Append daily diary entries via authenticated CLI path', // Temporarily disabled at root CLI.
+  // apikey: 'List/validate/set/delete API keys', // Temporarily disabled at root CLI.
+  // quickhack: 'Generate random tutorial secret, run set+inject, and print copyable commands', // Temporarily disabled at root CLI.
+  // agent: 'Retrieve/manage credentials (get, set, share via secret gist, delete, list)', // Temporarily disabled at root CLI.
+  // secret: 'Run commands with injected secret env vars (inject)', // Temporarily disabled at root CLI.
+  // env: 'Load env vars from agent via .aura file (run, inject, check, list, init)', // Temporarily disabled at root CLI.
 };
 
-const AGENT_ALIASES = {
-  get: 'get',
-  set: 'set',
-  share: 'share',
-  del: 'delete',
-  delete: 'delete',
-  list: 'list',
-  health: 'health',
-  getsecret: 'get',
-  'get-secret': 'get',
-  readsecret: 'get',
-  'read-secret': 'get',
-  listsecrets: 'list',
-  'list-secrets': 'list',
-  secretlist: 'list',
-  'secret-list': 'list',
-  secrethealth: 'health',
-  'secret-health': 'health',
-  secret: 'secret',
-  inject: 'inject',
-  use: 'inject',
-};
+// Temporarily disabled at root CLI.
+const AGENT_ALIASES = {};
+// const AGENT_ALIASES = {
+//   get: 'get',
+//   set: 'set',
+//   share: 'share',
+//   del: 'delete',
+//   delete: 'delete',
+//   list: 'list',
+//   health: 'health',
+//   getsecret: 'get',
+//   'get-secret': 'get',
+//   readsecret: 'get',
+//   'read-secret': 'get',
+//   listsecrets: 'list',
+//   'list-secrets': 'list',
+//   secretlist: 'list',
+//   'secret-list': 'list',
+//   secrethealth: 'health',
+//   'secret-health': 'health',
+//   secret: 'secret',
+//   inject: 'inject',
+//   use: 'inject',
+// };
 
 // Temporarily disabled at root CLI.
 // const SOCIAL_ALIASES = {
@@ -105,26 +110,34 @@ const COMMAND_ALIASES = {
   'agent-register': 'register-agent',
 };
 
-const SHORTCUT_COMMANDS = [
-  { name: 'get <name>', desc: 'Read primary credential value (--json for full payload)' },
-  { name: 'set <name> <value>', desc: 'Create or update a secret (default type: api key)' },
-  { name: 'list', desc: 'List credential names' },
-  { name: 'share <name>', desc: 'Create a GitHub secret gist share for a credential' },
-  { name: 'inject <name> [-- <cmd>]', desc: 'Save primary secret to env var (AURA_SECRET default) and optionally run command' },
-  { name: 'del <name>', desc: 'Delete a credential' },
-];
+// Temporarily disabled at root CLI.
+const SHORTCUT_COMMANDS = [];
+// const SHORTCUT_COMMANDS = [
+//   { name: 'get <name>', desc: 'Read primary credential value (--json for full payload)' },
+//   { name: 'set <name> <value>', desc: 'Create or update a secret (default type: api key)' },
+//   { name: 'list', desc: 'List credential names' },
+//   { name: 'share <name>', desc: 'Create a GitHub secret gist share for a credential' },
+//   { name: 'inject <name> [-- <cmd>]', desc: 'Save primary secret to env var (AURA_SECRET default) and optionally run command' },
+//   { name: 'del <name>', desc: 'Delete a credential' },
+// ];
 
 const DEFAULT_ADMIN = ['start', 'status', 'init', 'mcp', 'skill', 'auth'];
+const AURAJS_COMMANDS = ['create', 'make', 'play', 'fork', 'publish'];
+const HIDDEN_HELP_COMMANDS = new Set(['wallet']);
 
 const COMMON_EXAMPLES = [
   { cmd: 'aura status', note: 'Check if services are running' },
-  { cmd: 'aura list', note: 'List credential names' },
-  { cmd: 'aura diary write --entry "heartbeat ok"', note: 'Append a daily diary entry (auth-aware)' },
-  { cmd: 'aura get OURSECRET', note: 'Read a credential' },
-  { cmd: 'aura set OURSECRET 123', note: 'Create or update a credential value' },
-  { cmd: 'aura set GITHUB_LOGIN hunter2 --type login', note: 'Store as login credential (password field)' },
-  { cmd: 'aura share OURSECRET --expires-after 24h', note: 'Create a shareable secret gist link' },
-  { cmd: 'aura inject OURSECRET --env HIDETHIS -- printenv HIDETHIS', note: 'Execute command with injected secret env var' },
+  { cmd: 'aura doctor', note: 'Run local diagnostics' },
+  { cmd: 'aura skill --doctor', note: 'Check skill installation status' },
+  { cmd: 'aura mcp --install', note: 'Install MCP config for supported clients' },
+  { cmd: 'auramaxx make scene Scene1', note: 'Generate a scene in the current AuraJS project' },
+  { cmd: 'auramaxx fork aurasu ./aurasu-local', note: 'Fork a published AuraJS game into a local editable project' },
+  // { cmd: 'aura diary write --entry "heartbeat ok"', note: 'Append a daily diary entry (auth-aware)' }, // Temporarily disabled at root CLI.
+  // { cmd: 'aura get OURSECRET', note: 'Read a credential' }, // Temporarily disabled at root CLI.
+  // { cmd: 'aura set OURSECRET 123', note: 'Create or update a credential value' }, // Temporarily disabled at root CLI.
+  // { cmd: 'aura set GITHUB_LOGIN hunter2 --type login', note: 'Store as login credential (password field)' }, // Temporarily disabled at root CLI.
+  // { cmd: 'aura share OURSECRET --expires-after 24h', note: 'Create a shareable secret gist link' }, // Temporarily disabled at root CLI.
+  // { cmd: 'aura inject OURSECRET --env HIDETHIS -- printenv HIDETHIS', note: 'Execute command with injected secret env var' }, // Temporarily disabled at root CLI.
 ];
 
 let localTsxCliPath;
@@ -198,6 +211,15 @@ function resolveLocalTsxCliPath() {
   return localTsxCliPath;
 }
 
+function commandFilePath(commandName) {
+  return path.join(root, 'src', 'server', 'cli', 'commands', `${commandName}.ts`);
+}
+
+function isCommandAvailable(commandName) {
+  if (!COMMANDS[commandName]) return false;
+  return fs.existsSync(commandFilePath(commandName));
+}
+
 function showHelp(showAll = false) {
   // Inline Tyvek theme (bin/ is plain CJS - cannot import TS theme module)
   const isTTY = process.stdout.isTTY && !process.env.NO_COLOR && process.env.CI !== 'true' && process.env.TERM !== 'dumb';
@@ -230,58 +252,38 @@ function showHelp(showAll = false) {
   console.log(`  ${BL}${DIM}${' '.repeat(W - 4)}${RST}${BR}`);
   console.log('');
 
-  console.log(`  ${BOLD}Usage:${RST} aura [command] [options]`);
+  console.log(`  ${BOLD}Usage:${RST} auramaxx [command] [options]`);
+  console.log(`         ${DIM}aura [command] [options] (alias)${RST}`);
   console.log(`         ${DIM}npx auramaxx [command] [options]${RST}`);
   console.log('');
 
-  // --- OPTIONS ---
   console.log(SEP);
-  console.log(`  ${BOLD}[ OPTIONS ]${RST}`);
+  console.log(`  ${BOLD}[ AURAJS ]${RST}`);
   console.log('');
-  console.log(`    ${CYAN}${'--help'.padEnd(16)}${RST}Show this help message`);
-  console.log(`    ${CYAN}${'--help --all'.padEnd(16)}${RST}Show all commands including advanced admin`);
-  console.log(`    ${CYAN}${'--json'.padEnd(16)}${RST}Output full command metadata as JSON`);
-  console.log(`    ${CYAN}${'--env'.padEnd(16)}${RST}Save to env var, used together with aura inject`);
-  console.log(`    ${CYAN}${'--debug'.padEnd(16)}${RST}Show verbose bootstrap/setup details during start`);
+  for (const name of AURAJS_COMMANDS) {
+    if (isCommandAvailable(name)) {
+      console.log(`    ${CYAN}${name.padEnd(16)}${RST}${COMMANDS[name]}`);
+    }
+  }
   console.log('');
 
-  // --- ADMIN (essential or all) ---
   console.log(SEP);
   console.log(`  ${BOLD}[ ADMIN ]${RST}`);
   console.log('');
 
   if (showAll) {
     for (const [name, desc] of Object.entries(COMMANDS)) {
+      if (HIDDEN_HELP_COMMANDS.has(name) || !isCommandAvailable(name)) continue;
       console.log(`    ${CYAN}${name.padEnd(16)}${RST}${desc}`);
     }
   } else {
     for (const name of DEFAULT_ADMIN) {
-      if (COMMANDS[name]) {
+      if (isCommandAvailable(name) && !HIDDEN_HELP_COMMANDS.has(name)) {
         console.log(`    ${CYAN}${name.padEnd(16)}${RST}${COMMANDS[name]}`);
       }
     }
     console.log('');
-    console.log(`  ${DIM}Run aura --help --all to see all commands${RST}`);
-  }
-  console.log('');
-
-  // --- COMMANDS (aliases) ---
-  console.log(SEP);
-  console.log(`  ${BOLD}[ COMMANDS ]${RST}`);
-  console.log('');
-  const shortcutWidth = Math.max(...SHORTCUT_COMMANDS.map((shortcut) => shortcut.name.length)) + 2;
-  for (const shortcut of SHORTCUT_COMMANDS) {
-    console.log(`    ${CYAN}${shortcut.name.padEnd(shortcutWidth)}${RST}${shortcut.desc}`);
-  }
-  console.log('');
-
-  // --- EXAMPLES ---
-  console.log(SEP);
-  console.log(`  ${BOLD}[ EXAMPLES ]${RST}`);
-  console.log('');
-  const exampleWidth = Math.max(...COMMON_EXAMPLES.map((example) => example.cmd.length)) + 2;
-  for (const example of COMMON_EXAMPLES) {
-    console.log(`    ${example.cmd.padEnd(exampleWidth)}${DIM}# ${example.note}${RST}`);
+    console.log(`  ${DIM}Run auramaxx --help --all to see all commands${RST}`);
   }
   console.log('');
 }
@@ -290,20 +292,31 @@ function getHelpMetadata() {
   return {
     cli: 'auramaxx',
     usage: [
-      'npx auramaxx [command] [options]',
+      'auramaxx [command] [options]',
       'aura [command] [options] (alias)',
+      'npx auramaxx [command] [options]',
     ],
     options: [
       { flag: '--help', aliases: ['-h'], description: 'Show this help message' },
       { flag: '--json', description: 'Output full command metadata as JSON' },
-      { flag: '--env', description: 'Save to env var, used together with npx auramaxx inject' },
+      // { flag: '--env', description: 'Save to env var, used together with npx auramaxx inject' }, // Temporarily disabled at root CLI.
+      // { flag: '--env <name>', description: 'Save secret output into a named env var' }, // Temporarily disabled at root CLI.
     ],
-    commands: Object.entries(COMMANDS).map(([name, description]) => ({
-      name,
-      description,
-      entrypoint: `src/server/cli/commands/${name}.ts`,
-    })),
-    commandShortcuts: SHORTCUT_COMMANDS.map((entry) => ({ ...entry })),
+    commands: Object.entries(COMMANDS)
+      .filter(([name]) => !HIDDEN_HELP_COMMANDS.has(name) && isCommandAvailable(name))
+      .map(([name, description]) => ({
+        name,
+        description,
+        entrypoint: `src/server/cli/commands/${name}.ts`,
+      })),
+    // commandShortcuts: SHORTCUT_COMMANDS.map((entry) => ({ ...entry })), // Temporarily disabled at root CLI.
+    aurajsCommands: AURAJS_COMMANDS
+      .filter((name) => isCommandAvailable(name))
+      .map((name) => ({
+        name,
+        description: COMMANDS[name],
+        entrypoint: `src/server/cli/commands/${name}.ts`,
+      })),
     agentAliases: Object.entries(AGENT_ALIASES).map(([alias, subcommand]) => ({
       alias,
       command: 'agent',
@@ -318,9 +331,9 @@ function showHelpJson() {
 }
 
 function resolveDefaultCommand() {
-  // Canonical golden path: always start.
-  // `start` now owns first-run bootstrap/setup checks and returning-run startup.
-  return 'start';
+  if (isCommandAvailable('create')) return 'create';
+  if (isCommandAvailable('start')) return 'start';
+  return 'help';
 }
 
 function getDataDirState(dataDir) {
@@ -782,7 +795,10 @@ function runCommand(commandName, commandArgs = [], allowFailure = false, quiet =
     execFileSync(runner.command, runner.args, {
       cwd: root,
       stdio: quiet ? 'ignore' : 'inherit',
-      env: process.env,
+      env: {
+        ...process.env,
+        AURA_INVOKE_CWD: process.env.AURA_INVOKE_CWD || process.cwd(),
+      },
     });
     return true;
   } catch (error) {
@@ -862,7 +878,10 @@ function runOnboardingFlow() {
     execFileSync(runner.command, runner.args, {
       cwd: root,
       stdio: 'inherit',
-      env: process.env,
+      env: {
+        ...process.env,
+        AURA_INVOKE_CWD: process.env.AURA_INVOKE_CWD || process.cwd(),
+      },
     });
   } catch (error) {
     process.exit(error.status || 1);
@@ -1291,7 +1310,7 @@ async function main() {
       const repaired = await maybeHandleBrokenLocalState();
       if (repaired) cmd = repaired;
     }
-    if (cmd !== 'start') {
+    if (cmd !== 'start' && cmd !== 'create') {
       console.log(`No command provided; running '${cmd}'.`);
     }
   }
@@ -1320,10 +1339,11 @@ async function main() {
     process.exit(0);
   }
 
-  if (cmd && AGENT_ALIASES[cmd]) {
-    args.unshift(AGENT_ALIASES[cmd]);
-    cmd = 'agent';
-  }
+  // Temporarily disabled at root CLI.
+  // if (cmd && AGENT_ALIASES[cmd]) {
+  //   args.unshift(AGENT_ALIASES[cmd]);
+  //   cmd = 'agent';
+  // }
 
   // Temporarily disabled at root CLI.
   // if (cmd && SOCIAL_ALIASES[cmd]) {
@@ -1341,6 +1361,12 @@ async function main() {
     process.exit(1);
   }
 
+  if (!isCommandAvailable(cmd)) {
+    console.error(`Command '${cmd}' is not included in this auramaxx package build right now.\n`);
+    console.error(`Run 'auramaxx --help' to see the currently available commands.`);
+    process.exit(1);
+  }
+
   // Start is canonical: if no wallet exists yet, transparently route through init/setup.
   if (cmd === 'start') {
     const dataDir = process.env.WALLET_DATA_DIR || path.join(os.homedir(), '.auramaxx');
@@ -1365,12 +1391,16 @@ async function main() {
   maybeInitFeatureFlags();
 
   const runner = buildRunner(cmd, args);
+  const invokeCwd = process.env.AURA_INVOKE_CWD || process.cwd();
 
   try {
     execFileSync(runner.command, runner.args, {
       cwd: root,
       stdio: 'inherit',
-      env: process.env,
+      env: {
+        ...process.env,
+        AURA_INVOKE_CWD: invokeCwd,
+      },
     });
   } catch (error) {
     // tsx already printed the error, just exit with its code

package/package.json

@@ -1,115 +1,39 @@
 {
   "name": "auramaxx",
-  "version": "0.0.19",
-  "description": "Securely share passwords, API keys and wallets with your agent.",
+  "version": "0.1.0",
+  "description": "AuraJS CLI for creating, playing, and publishing JavaScript-first games.",
   "keywords": [
-    "onepassword",
-    "ai-agent",
-    "openclaw",
-    "claude",
-    "codex",
-    "secrets",
-    "credentials",
-    "mcp",
+    "aurajs",
+    "auramaxx",
+    "game-engine",
+    "gamedev",
     "cli",
-    "automation"
+    "javascript",
+    "native"
   ],
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Aura-Industry/auramaxx.git"
   },
-  "main": "apps/desktop-electron/main.js",
+  "main": "bin/auramaxx.js",
   "bin": {
     "auramaxx": "./bin/auramaxx.js",
     "aura": "./bin/auramaxx.js"
   },
   "files": [
-    "bin/",
-    ".next/",
-    "!.next/cache/",
-    "src/server/",
-    "!src/server/tests/",
-    "!src/server/test-data/",
-    "!src/server/vitest.config.ts",
-    "!src/server/node_modules/",
-    "shared/",
-    "src/",
-    "!src/__tests__/",
-    "!src/internal/",
-    "!src/internal/**",
-    "!src/node_modules/",
-    "public/",
-    "!public/*.dmg",
-    "!public/*.exe",
-    "!public/*.AppImage",
-    "!public/*.snap",
-    "!public/*.deb",
-    "!public/*.rpm",
-    "!public/*.blockmap",
-    "prisma/",
-    "!prisma/dev.db",
-    "!prisma/dev.db-journal",
-    "!prisma/**/*.db",
-    "!prisma/**/*.db-journal",
-    "scripts/add-app.js",
-    "skills/",
-    "docs/",
-    "!docs/internal/",
-    "!docs/internal/**",
-    "!docs/specs/",
-    "!docs/specs/**",
-    "start.sh",
-    "tsconfig.json",
-    "next.config.ts",
-    "tailwind.config.ts",
-    "postcss.config.mjs"
+    "bin/auramaxx.js",
+    "src/lib/startBannerQuotes.ts",
+    "src/server/cli/commands/onboard.ts",
+    "src/server/cli/commands/create.ts",
+    "src/server/cli/commands/play.ts",
+    "src/server/cli/commands/publish.ts",
+    "src/server/cli/lib/prompt.ts",
+    "src/server/cli/lib/theme.ts"
   ],
   "scripts": {
-    "prebuild": "node -e \"require('node:fs').rmSync('.next', { recursive: true, force: true })\"",
-    "postinstall": "prisma generate --schema ./prisma/schema.prisma",
-    "build": "next build",
-    "typecheck": "tsc --noEmit && tsc --noEmit -p src/server/tsconfig.json",
-    "typecheck:server": "tsc --noEmit -p src/server/tsconfig.json",
-    "prepack": "npm run build",
     "auramaxx": "node ./bin/auramaxx.js",
-    "auramaxx:dev": "node ./bin/auramaxx.js start --dev",
-    "auramaxx:debug": "node ./bin/auramaxx.js --debug",
-    "aura": "node ./bin/auramaxx.js",
-    "test": "vitest run --config src/server/vitest.config.ts",
-    "test:ai": "vitest run --config src/server/tests/ai-integration/vitest.config.ts",
-    "test:setup": "vitest run --config src/server/tests/setup-integration/vitest.config.ts",
-    "test:ai:live": "vitest run --config src/server/tests/ai-integration/vitest.live.config.ts",
-    "test:watch": "vitest --config src/server/vitest.config.ts",
-    "test:coverage": "vitest run --config src/server/vitest.config.ts --coverage",
-    "test:cli": "vitest run --config src/server/vitest.config.ts tests/cli/",
-    "test:e2e": "vitest run --config src/server/vitest.config.ts tests/e2e.test.ts",
-    "test:ui": "vitest run --config src/__tests__/vitest.config.ts",
-    "test:ui:watch": "vitest --config src/__tests__/vitest.config.ts",
-    "test:e2e-agent:smoke": "vitest run --config src/server/vitest.config.ts tests/e2e-agent/**/*.test.ts",
-    "test:runtime-agent-smoke": "vitest run --config src/server/vitest.config.ts tests/runtime-agent-smoke.test.ts",
-    "test:e2e-agent:nightly": "vitest run --config src/server/vitest.config.ts tests/e2e-agent/**/*.test.ts",
-    "test:cd:cli": "vitest run --config src/server/vitest.config.ts tests/sandbox/cli.test.ts",
-    "test:cd:cli:suite": "vitest run --config src/server/vitest.config.ts tests/sandbox/",
-    "test:cd:cli:alias": "vitest run --config src/server/vitest.config.ts tests/sandbox/cli.test.ts -t \"routes dev aliases to local CLI for agent shortcuts\"",
-    "test:cd:cli:e2e": "./scripts/cd-cli-e2e.sh",
-    "test:sandbox:agent-flow": "./scripts/sandbox-agent-flow.sh",
-    "test:sandbox:agent-prepublish": "npm run test:sandbox:agent-flow",
-    "nuke": "node ./bin/auramaxx.js nuke --yes",
-    "sandbox": "./scripts/sandbox.sh terminal",
-    "sandbox:dev": "./scripts/sandbox.sh terminal --dev",
-    "sandbox:dashboard": "./scripts/sandbox.sh dashboard",
-    "sandbox:dashboard:dev": "./scripts/sandbox.sh dashboard --dev",
-    "sandbox:mcp": "./scripts/sandbox.sh mcp",
-    "sandbox:agent": "./scripts/sandbox.sh agent",
-    "desktop": "electron apps/desktop-electron/main.js",
-    "desktop:build": "electron-builder --config apps/desktop-electron/electron-builder.yml",
-    "desktop:build:mac": "electron-builder --config apps/desktop-electron/electron-builder.yml --mac",
-    "desktop:build:win": "electron-builder --config apps/desktop-electron/electron-builder.yml --win",
-    "desktop:build:linux": "electron-builder --config apps/desktop-electron/electron-builder.yml --linux",
-    "security:protected-gate": "python3 scripts/task_queue.py protected-gate",
-    "security:protected-gate:strict": "python3 scripts/task_queue.py protected-gate --fail-on-touch",
-    "security:install-hooks": "./scripts/install-git-hooks.sh"
+    "aura": "node ./bin/auramaxx.js"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.73.0",