amorphous-cli 0.1.8 → 0.1.10

package/README.md

@@ -1,6 +1,6 @@
 # amorphous-cli
 
-Make whatever you want, yourself, with your own agent, or with others. And whatever you want can be private, public, or even have users.
+Make whatever you want, yourself, with your own agent, or with others. And whatever you want can be private, public, or even have users of its own.
 
 ```bash
 npx amorphous-cli@latest setup

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.10",
   "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

@@ -3,7 +3,7 @@ name: amorphous
 description: Make whatever you want, yourself, with your own agent, or with others. Use when someone wants an abstract other people can open, or wants to invite people, publish, or change an abstract.
 ---
 
-Make whatever you want, yourself, with your own agent, or with others. And whatever you want can be private, public, or even have users.
+Make whatever you want, yourself, with your own agent, or with others. And whatever you want can be private, public, or even have users of its own.
 
 ## Files
 
@@ -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.