amorphous-cli 0.1.8 → 0.1.9

package/hooks/session-start.mjs

@@ -48,7 +48,7 @@ if (target === 'cursor') {
   process.stdout.write(
     `${JSON.stringify({
       additional_context:
-        'The Amorphous skill on this machine was just updated. Read ~/.agents/skills/amorphous/SKILL.md and follow it. Invoke the CLI as npx amorphous-cli@latest.',
+        'The Amorphous skill on this machine was just updated. Read ~/.agents/skills/amorphous/SKILL.md and follow it. Install the CLI with npm install -g amorphous-cli@latest and invoke it as amorphous-cli.',
     })}\n`,
   )
 } else {

package/lib/api.mjs

@@ -2,24 +2,24 @@ import { cliAppFetchOrigin, cliAppHostHeader } from './config.mjs'
 import { ensureFreshSession } from './session.mjs'
 
 const FRIENDLY = {
-  'You already own 2 abstracts': 'You already own 2 abstracts. Run: npx amorphous-cli@latest list',
-  'This abstract already has 8 people': 'This abstract already has 8 people. Run: npx amorphous-cli@latest people',
+  'You already own 2 abstracts': 'You already own 2 abstracts. Run: amorphous-cli list',
+  'This abstract already has 8 people': 'This abstract already has 8 people. Run: amorphous-cli people',
   'User not found': 'No account with that email yet.',
-  'Grant failed': 'Could not invite. Run: npx amorphous-cli@latest people',
-  'Cannot revoke owner': "You can't remove the owner. Run: npx amorphous-cli@latest people",
-  'Cannot remove yourself': "You can't remove yourself. Run: npx amorphous-cli@latest people",
-  'Collection not found': 'Folder not found. Run: npx amorphous-cli@latest folder list',
-  Forbidden: "You don't have access. Run: npx amorphous-cli@latest list",
-  'Not Found': 'Not found. Run: npx amorphous-cli@latest list',
-  'Owner required': 'Only the owner can do that. Run: npx amorphous-cli@latest people',
-  'id required': 'Missing id. Run: npx amorphous-cli@latest list',
-  'userId required': 'Pass an email or id. Run: npx amorphous-cli@latest people',
-  'Invalid body': 'Invalid request. Run: npx amorphous-cli@latest pull',
-  'Name required': 'Name required. Run: npx amorphous-cli@latest rename --name <name>',
-  'Create failed': 'Could not create the abstract. Run: npx amorphous-cli@latest list',
-  'Publish failed': 'Could not publish. Run: npx amorphous-cli@latest push',
-  'File too large': 'That file is too large. Run: npx amorphous-cli@latest pull',
-  'Not logged in. Run: amorphous login <email>': 'Not signed in. Run: npx amorphous-cli@latest login',
+  'Grant failed': 'Could not invite. Run: amorphous-cli people',
+  'Cannot revoke owner': "You can't remove the owner. Run: amorphous-cli people",
+  'Cannot remove yourself': "You can't remove yourself. Run: amorphous-cli people",
+  'Collection not found': 'Folder not found. Run: amorphous-cli folder list',
+  Forbidden: "You don't have access. Run: amorphous-cli list",
+  'Not Found': 'Not found. Run: amorphous-cli list',
+  'Owner required': 'Only the owner can do that. Run: amorphous-cli people',
+  'id required': 'Missing id. Run: amorphous-cli list',
+  'userId required': 'Pass an email or id. Run: amorphous-cli people',
+  'Invalid body': 'Invalid request. Run: amorphous-cli pull',
+  'Name required': 'Name required. Run: amorphous-cli rename --name <name>',
+  'Create failed': 'Could not create the abstract. Run: amorphous-cli list',
+  'Publish failed': 'Could not publish. Run: amorphous-cli push',
+  'File too large': 'That file is too large. Run: amorphous-cli pull',
+  'Not logged in. Run: amorphous login <email>': 'Not signed in. Run: amorphous-cli login',
 }
 
 export function friendlyMessage(raw) {

package/lib/commands.mjs

@@ -77,7 +77,7 @@ function writeMeta(cwd, abstractId) {
 function requireMeta(cwd) {
   const meta = readMeta(cwd)
   if (!meta?.abstractId) {
-    throw new Error('No .amorphous.json here. Run npx amorphous-cli@latest create first.')
+    throw new Error('No .amorphous.json here. Run amorphous-cli create first.')
   }
   return meta.abstractId
 }
@@ -339,7 +339,7 @@ async function cmdPush(cwd, rest) {
       body: JSON.stringify({ records: localRecords }),
     })
     if (refused?.length) {
-      console.error(`Skipped (already live): ${refused.join(', ')}. Run: npx amorphous-cli@latest pull`)
+      console.error(`Skipped (already live): ${refused.join(', ')}. Run: amorphous-cli pull`)
     }
   }
   const { html, css, js } = readProjectFiles(cwd)
@@ -799,6 +799,6 @@ export async function runCommand(argv, cwd = process.cwd()) {
       if (rest[0] === 'member') return cmdSpaceMember(rest.slice(1))
       throw new Error('Use folder instead.')
     default:
-      throw new Error(`Unknown command “${raw}”. Run npx amorphous-cli@latest --help.`)
+      throw new Error(`Unknown command “${raw}”. Run amorphous-cli --help.`)
   }
 }

package/lib/help.mjs

@@ -29,7 +29,7 @@ export const ROOT_HELP = `Amorphous
   folder people                 People on a folder
   rename --name                 Rename
 
-Run npx amorphous-cli@latest <command> --help for flags. Pass --json where you need machine output.
+Run amorphous-cli <command> --help for flags. Pass --json where you need machine output.
 `
 
 export const COMMAND_HELP = {

package/lib/login.mjs

@@ -70,7 +70,7 @@ async function loginViaMailpit(supabase, email, redirectTo, sinceMs) {
 async function readCode(email) {
   if (!process.stdin.isTTY) {
     throw new Error(
-      `Code sent to ${email}. Read it from that inbox, then run: npx amorphous-cli@latest login ${email} --code <code>`,
+      `Code sent to ${email}. Read it from that inbox, then run: amorphous-cli login ${email} --code <code>`,
     )
   }
   const rl = createInterface({ input: process.stdin, output: process.stderr })

package/lib/serve.mjs

@@ -219,7 +219,7 @@ export function startServe(options) {
     if (options.prodFetch) return options.prodFetch(abstractId, path, init, session)
     const cookie = await ensurePass()
     if (!cookie && init.auth !== false) {
-      return new Response(JSON.stringify({ message: 'Not signed in. Run: npx amorphous-cli@latest login' }), {
+      return new Response(JSON.stringify({ message: 'Not signed in. Run: amorphous-cli login' }), {
         status: 401,
         headers: { 'Content-Type': 'application/json' },
       })

package/lib/session.mjs

@@ -58,7 +58,7 @@ async function withCredentialLock(dir, fn) {
         /* the other process released it */
       }
       if (Date.now() - started > LOCK_WAIT_MS) {
-        throw new Error('Not signed in. Run: npx amorphous-cli@latest login')
+        throw new Error('Not signed in. Run: amorphous-cli login')
       }
       await sleep(25)
     }
@@ -115,11 +115,11 @@ export async function ensureFreshSession(options = {}) {
     const now = options.now ?? Date.now()
     const session = loadSession()
     if (!session?.access_token) {
-      throw new Error('Not signed in. Run: npx amorphous-cli@latest login')
+      throw new Error('Not signed in. Run: amorphous-cli login')
     }
     if (!options.force && !sessionNeedsRefresh(session, now)) return session
     if (!session.refresh_token) {
-      throw new Error('Not signed in. Run: npx amorphous-cli@latest login')
+      throw new Error('Not signed in. Run: amorphous-cli login')
     }
     const refresh = options.refresh ?? refreshWithSupabase
     try {
@@ -135,7 +135,7 @@ export async function ensureFreshSession(options = {}) {
       ) {
         return again
       }
-      throw new Error('Not signed in. Run: npx amorphous-cli@latest login')
+      throw new Error('Not signed in. Run: amorphous-cli login')
     }
   })
 }
@@ -148,7 +148,7 @@ export function accessToken() {
 export function authHeaders(extra = {}) {
   const token = accessToken()
   if (!token) {
-    throw new Error('Not signed in. Run: npx amorphous-cli@latest login')
+    throw new Error('Not signed in. Run: amorphous-cli login')
   }
   return {
     Authorization: `Bearer ${token}`,

package/lib/tool-result.test.mjs

@@ -2,14 +2,14 @@ import assert from 'node:assert/strict'
 import test from 'node:test'
 import { toolText } from './tool-result.mjs'
 
-const NUDGE = 'Run: npx amorphous-cli@latest setup'
+const NUDGE = 'Run: npm install -g amorphous-cli@latest && amorphous-cli setup'
 
 test('a successful command keeps stderr the model must see', () => {
   assert.equal(toolText('[{"id":"a"}]', `${NUDGE}\n`, 0), `[{"id":"a"}]\n${NUDGE}`)
 })
 
 test('a failed command returns the error text', () => {
-  assert.equal(toolText('', 'Not signed in. Run: npx amorphous-cli@latest login\n', 1), 'Not signed in. Run: npx amorphous-cli@latest login')
+  assert.equal(toolText('', 'Not signed in. Run: amorphous-cli login\n', 1), 'Not signed in. Run: amorphous-cli login')
 })
 
 test('empty success is ok', () => {

package/lib/update-check.mjs

@@ -8,7 +8,7 @@ import { userSkillDirs } from './agent-contract.mjs'
 import { CLI_VERSION } from './version.mjs'
 
 const CACHE_TTL_MS = 24 * 60 * 60 * 1000
-const NUDGE = 'Run: npx amorphous-cli@latest setup\n'
+const NUDGE = 'Run: npm install -g amorphous-cli@latest && amorphous-cli setup\n'
 
 function parseVersion(v) {
   if (typeof v !== 'string') return null

package/lib/update-check.test.mjs

@@ -14,7 +14,7 @@ import {
   startUpdateCheck,
 } from './update-check.mjs'
 
-const NUDGE = 'Run: npx amorphous-cli@latest setup\n'
+const NUDGE = 'Run: npm install -g amorphous-cli@latest && amorphous-cli setup\n'
 
 test('compareVersions', () => {
   assert.equal(compareVersions('1.0.0', '1.0.0'), 0)
@@ -252,7 +252,7 @@ test('non-setup refreshes a stale skill when registry matches', async () => {
   await update.finish()
   assert.equal(err, '')
   assert.equal(readFileSync(join(d0, '.amorphous-version'), 'utf8').trim(), CLI_VERSION)
-  assert.match(readFileSync(join(d0, 'SKILL.md'), 'utf8'), /npx amorphous-cli@latest/)
+  assert.match(readFileSync(join(d0, 'SKILL.md'), 'utf8'), /npm install -g amorphous-cli@latest/)
 })
 
 test('a newer registry is not copied over the installed skill', async () => {
@@ -291,6 +291,6 @@ test('integration help skips update check file', () => {
     encoding: 'utf8',
   })
   assert.equal(r.status, 0)
-  assert.ok(!r.stderr.includes('Run: npx amorphous-cli@latest setup'))
+  assert.ok(!r.stderr.includes('Run: npm install -g amorphous-cli@latest && amorphous-cli setup'))
   assert.throws(() => readFileSync(cacheFile(home)), { code: 'ENOENT' })
 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amorphous-cli",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "mcpName": "io.github.amorphous-one/amorphous",
   "description": "Make whatever you want, yourself, with your own agent, or with others.",
   "type": "module",

package/skill/amorphous/SKILL.md

@@ -32,18 +32,18 @@ A private record belongs to the signed-in person who wrote it. The abstract does
 
 ## Loop
 
-Call the CLI as `npx amorphous-cli@latest <command>`. If a command prints `Run: npx amorphous-cli@latest setup`, run that line, then repeat the command.
+Install the CLI once with `npm install -g amorphous-cli@latest`, then call it as `amorphous-cli <command>`. If a command prints `Run: npm install -g amorphous-cli@latest && amorphous-cli setup`, run that line, then repeat the command.
 
-1. If you are not signed in, run `npx amorphous-cli@latest login`. Show the person the link it prints and ask them to finish in the browser. Do not ask for an email or a code.
-2. `npx amorphous-cli@latest create --name "..."` in a folder, or `npx amorphous-cli@latest pull` when `.amorphous.json` is already there.
+1. If you are not signed in, run `amorphous-cli login`. Show the person the link it prints and ask them to finish in the browser. Do not ask for an email or a code.
+2. `amorphous-cli create --name "..."` in a folder, or `amorphous-cli pull` when `.amorphous.json` is already there.
 3. Edit the files to match what they asked for. `me` and `names` are how the abstract knows who is here.
-4. `npx amorphous-cli@latest serve` and open that URL. It reloads when the files change. Records on that page start in this folder. Switch the page to prod to read and write the abstract's records.
-5. `npx amorphous-cli@latest push` sends the source. `npx amorphous-cli@latest push --data` also sends the records in this folder.
-6. `npx amorphous-cli@latest preview` and open that URL.
-7. `npx amorphous-cli@latest publish --live`
-8. `npx amorphous-cli@latest invite <email> use` or `edit` or `view`. It prints a link and does not send an email. Give them that link. They open it and sign in with that email.
+4. `amorphous-cli serve` and open that URL. It reloads when the files change. Records on that page start in this folder. Switch the page to prod to read and write the abstract's records.
+5. `amorphous-cli push` sends the source. `amorphous-cli push --data` also sends the records in this folder.
+6. `amorphous-cli preview` and open that URL.
+7. `amorphous-cli publish --live`
+8. `amorphous-cli invite <email> use` or `edit` or `view`. It prints a link and does not send an email. Give them that link. They open it and sign in with that email.
 
-`npx amorphous-cli@latest visibility anyone` lets anyone view and write shared records. `npx amorphous-cli@latest visibility members` keeps the abstract to invited people.
+`amorphous-cli visibility anyone` lets anyone view and write shared records. `amorphous-cli visibility members` keeps the abstract to invited people.
 
 Do not make a public abstract that lets anyone keep adding shared records, such as an open list. Those records stay on the abstract and use up its storage. Keep shared records to a set you replace, or keep the abstract to invited people.