atris 3.25.0 → 3.25.2

package/README.md

@@ -87,7 +87,7 @@ Integrates with any agent.
 
 ## Chat With Atris 2
 
-`ax` is the Atris 2 chat and coding-agent CLI. It uses the hosted Atris cloud by default, streams text, shows tool activity, and keeps fresh installs away from backend setup.
+`ax` is the Atris 2 chat and coding-agent CLI. It uses the hosted Atris cloud by default, streams text, shows tool activity, and keeps fresh installs away from local setup.
 
 ```bash
 cd your-project

package/ax

@@ -349,7 +349,7 @@ function buildRunProfile(options = {}) {
       workspace_path: isCodeFastLocal(options) ? cwd : 'cloud scratch',
       max_turns: 1,
       streaming: false,
-      runtime: isCodeFastLocal(options) ? 'local Cursor SDK through backend' : 'authenticated Code Fast cloud scratch',
+      runtime: isCodeFastLocal(options) ? 'local Cursor SDK bridge' : 'authenticated Code Fast cloud scratch',
       reasoning: 'Composer 2.5 fast lane; charges 10 credits per public turn'
     };
   }
@@ -368,10 +368,10 @@ function buildRunProfile(options = {}) {
     streaming: true,
     runtime: route === 'cloud' ? 'authenticated cloud connectors/chat' : 'local workspace',
     reasoning: mode === 'max'
-      ? 'backend reports run row; Max workspace tool loop uses high reasoning effort'
+      ? 'Atris cloud service; Max workspace tool loop uses high reasoning effort'
       : mode === 'pro'
-        ? 'backend reports run row; Pro workspace tool loop uses API default medium'
-        : 'backend reports run row; Fast workspace tool loop uses provider default'
+        ? 'Atris cloud service; Pro workspace tool loop uses API default medium'
+        : 'Atris cloud service; Fast workspace tool loop uses provider default'
   };
 }
 
@@ -2872,16 +2872,18 @@ function formatChatDogfoodStatusReport(status) {
   return lines.join('\n');
 }
 
-function printBackendHint() {
+function printBackendHint(options = {}) {
   console.log('');
   console.log('Hosted lane:');
   console.log('ax --cloud "hello"');
   console.log('');
   console.log('Cloud API:');
   console.log(`ATRIS_API_BASE=${BACKEND.publicBase}`);
-  console.log('');
-  console.log('Local workspace lane:');
-  console.log(`Set AX_BACKEND_URL=http://${BACKEND.host}:${BACKEND.port} after starting a local Atris2 backend.`);
+  if (options.route === 'local' || options.forceLocal) {
+    console.log('');
+    console.log('Local developer lane:');
+    console.log(`Set AX_BACKEND_URL=http://${BACKEND.host}:${BACKEND.port} after starting your local Atris2 service.`);
+  }
 }
 
 function bufferedOutput() {
@@ -3243,7 +3245,7 @@ async function main() {
     console.log(formatDoneLine(result.durationMs, creditsFromState(result)));
   } catch (error) {
     console.error(`x ${error.message}`);
-    printBackendHint();
+    printBackendHint(runOptions);
     process.exit(1);
   }
 }

package/bin/atris.js

@@ -1455,7 +1455,7 @@ if (command === 'init') {
       console.error(`✗ Chat failed: ${error.message || error}`);
       process.exit(1);
     });
-} else if (command === 'fast' || (command === 'ax' && process.argv[3] === 'fast')) {
+} else if (command === 'fast' || command === 'ax') {
   atrisFastChat()
     .then(() => process.exit(0))
     .catch((error) => {

package/commands/align.js

@@ -466,6 +466,26 @@ async function alignHardLocalToCloud(token, biz, localDir) {
 
 async function alignAtris() {
   // Parse args
+  const printUsage = () => {
+    console.log('Usage: atris align [business] [--fix] [--hard] [--from cloud|local] [--dry-run]');
+    console.log('');
+    console.log('  atris align                   Diff current workspace against cloud (auto-detect)');
+    console.log('  atris align example-co            Diff example-co workspace');
+    console.log('  atris align example-co --fix      Fix drift (local is canonical by default)');
+    console.log('  atris align example-co --fix --hard  Force-push: nuke cloud cruft, upload local. Skips diff. Fast.');
+    console.log('  atris align example-co --fix --from cloud  Cloud is canonical: pull EC2-only, delete local extras');
+    console.log('  atris align example-co --dry-run  Show what would change, do nothing');
+  };
+
+  // Explicit help must win before we try to auto-detect a business slug,
+  // otherwise `--help` gets overwritten by the .atris/business.json fallback
+  // and the command attempts a real align instead of printing usage.
+  const firstArg = process.argv[3];
+  if (firstArg === '--help' || firstArg === '-h' || firstArg === 'help') {
+    printUsage();
+    process.exit(0);
+  }
+
   let slug = process.argv[3];
   if (!slug || slug.startsWith('-')) {
     const bizFile = path.join(process.cwd(), '.atris', 'business.json');
@@ -475,15 +495,8 @@ async function alignAtris() {
     if (!slug || slug.startsWith('-')) slug = null;
   }
 
-  if (!slug || slug === '--help' || slug === '-h' || slug === 'help') {
-    console.log('Usage: atris align [business] [--fix] [--hard] [--from cloud|local] [--dry-run]');
-    console.log('');
-    console.log('  atris align                   Diff current workspace against cloud (auto-detect)');
-    console.log('  atris align example-co            Diff example-co workspace');
-    console.log('  atris align example-co --fix      Fix drift (local is canonical by default)');
-    console.log('  atris align example-co --fix --hard  Force-push: nuke cloud cruft, upload local. Skips diff. Fast.');
-    console.log('  atris align example-co --fix --from cloud  Cloud is canonical: pull EC2-only, delete local extras');
-    console.log('  atris align example-co --dry-run  Show what would change, do nothing');
+  if (!slug) {
+    printUsage();
     process.exit(0);
   }
 

package/commands/skill.js

@@ -622,15 +622,19 @@ curl -s "https://api.atris.ai/api/integrations/YOUR_INTEGRATION/items" \\
 // --- CREATE subcommand ---
 
 function skillCreate(nameArg, ...flags) {
-  if (!nameArg) {
-    console.error('Usage: atris skill create <name> [--integration] [--description="..."] [--local]');
-    console.error('');
-    console.error('Examples:');
-    console.error('  atris skill create daily-standup');
-    console.error('  atris skill create email-outreach --integration');
-    console.error('  atris skill create example-co/bol-processor --integration');
-    console.error('  atris skill create my-skill --local     # project only, skip system dirs');
-    process.exit(1);
+  // A flag-shaped first arg is not a skill name (e.g. `skill create --help`);
+  // show usage instead of creating a junk folder named "--help".
+  const wantsHelp = nameArg === '--help' || nameArg === '-h' || nameArg === 'help';
+  if (!nameArg || nameArg.startsWith('-')) {
+    const out = wantsHelp ? console.log : console.error;
+    out('Usage: atris skill create <name> [--integration] [--description="..."] [--local]');
+    out('');
+    out('Examples:');
+    out('  atris skill create daily-standup');
+    out('  atris skill create email-outreach --integration');
+    out('  atris skill create example-co/bol-processor --integration');
+    out('  atris skill create my-skill --local     # project only, skip system dirs');
+    process.exit(wantsHelp ? 0 : 1);
   }
 
   const isIntegration = flags.includes('--integration');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "3.25.0",
+  "version": "3.25.2",
   "main": "bin/atris.js",
   "bin": {
     "atris": "bin/atris.js",