agent-transport-system 0.1.2 → 0.1.3

package/README.md

@@ -1,10 +1,22 @@
 # Agent Transport System CLI
 
-Official CLI for ATS Gateway/Core.
+Official command-line client for Agent Transport System.
 
-## Install
+### AGENT TRANSPORT SYSTEM
+---
+
+Globally connect with all AI agents and humans in seconds with one command.
+
+### What is Agent Transport System?
+---
+
+ATS is a transport layer for connecting all humans and any AI agents from anywhere together.
 
-Global install (published package):
+One command gives you secure spaces to spin up any kind of agent organization you want in seconds from anywhere.
+
+Imagine you can create a space for your team and let them talk to each other's agents in realtime.
+
+## Install
 
 ```bash
 npm install -g agent-transport-system@latest
@@ -16,111 +28,222 @@ Verify:
 ats --help
 ```
 
-## Core Commands
-
-- `ats start` — initialize identity profile (human or agent).
-- `ats space` — create/join/watch/send/history/guidelines.
-- `ats whoami` — print current identity.
-- `ats profile` — create/list/set/delete local profiles.
-- `ats doctor` — local setup and connectivity checks.
-- `ats view` — get/set default view mode (`auto|human|agent`).
-- `ats adapter` — install ATS adapter support for local coding agents.
+## Command Overview
+
+- `ats start` onboarding and baseline setup
+- `ats auth` authentication menu and status
+- `ats login` / `ats logout` quick auth aliases
+- `ats whoami` current auth + profile context
+- `ats profiles` profile management (`ats profile` is an alias)
+- `ats space` space lifecycle and messaging (`ats spaces` is an alias)
+- `ats agents` local agent registration and configuration
+- `ats skills` local skills install/update/uninstall
+- `ats service` background service lifecycle (`ats daemon` is an alias)
+- `ats doctor` local diagnostics and optional repair
+- `ats view` default view mode (`auto|human|agent`)
+- `ats upgrade` CLI version check/upgrade
+- `ats reset` strict local reset
 
 ## Quick Start
 
-Initialize identity:
+1. Login:
+
+```bash
+ats login
+```
+
+2. Run onboarding:
 
 ```bash
 ats start
 ```
 
-Create a space and join:
+3. Create a space and join:
 
 ```bash
 ats space create --name spaceship --join
 ```
 
-From another terminal, join and chat:
+4. In another terminal, join the same space:
+
+```bash
+ats space join <space-id> --history-limit 100
+```
+
+5. Send and read messages:
 
 ```bash
-ats space join spaceship --history-limit 100
+ats space send <space-id> "hello from Mars deck"
+ats space history <space-id> --limit 20
+ats space watch <space-id> --history-limit 100
 ```
 
-Send one message without interactive session:
+## Authentication
 
 ```bash
-ats space send spaceship "hello from Mars deck"
+ats auth
+ats auth status
+ats auth login --method device
+ats auth login --method ott --ott <one-time-token>
+ats auth logout
+
+# aliases
+ats login --method device
+ats logout
 ```
 
-Read recent history:
+## Profiles
 
 ```bash
-ats space history spaceship --limit 20
+ats profiles
+ats profiles list
+ats profiles create --name "Ops Human" --kind human
+ats profiles create --name "Build Agent" --kind agent
+ats profiles set <profile-id>
+ats profiles update <profile-id> --name "Build Agent v2"
+ats profiles delete <profile-id> --force
 ```
 
-Read-only stream:
+## Spaces
 
 ```bash
-ats space watch spaceship --history-limit 100
+ats space
+ats space list --limit 20
+ats space create --name "release-room" --guidelines "Keep updates concise"
+ats space join <space-id>
+ats space watch <space-id>
+ats space send <space-id> "status update"
+ats space history <space-id> --limit 20
+ats space guidelines <space-id>
+ats space guidelines <space-id> "New guidelines text"
+ats space password <space-id> --password <new-password>
+ats space password <space-id> --clear
+ats space add-members <space-id> --member <profile-id>
+ats space add-members <space-id> --all
+ats space delete <space-id>
 ```
 
-Space metadata fields synced by CLI:
+Space aliases:
 
-- `name`
-- `creator`
-- `createdAt` (mirrored locally as `spaceCreatedAt`)
-- `guidelines`
+```bash
+# alias of: ats space send
+ats send --space <space-id> "hello"
 
-## Gateway URL Resolution
+# alias of: ats space history
+ats tail --space <space-id> --limit 20
+```
 
-CLI resolves gateway URL in this order:
+Agent join mention alias behavior:
 
-1. `--gateway-url`
-2. `ATS_GATEWAY_URL`
-3. `~/.ats/config.json`
-4. Built-in default: `https://gateway.ats.sh`
+- Use `--mention-alias <token>` to set explicit alias for `@alias`.
+- If omitted and no alias exists yet, agent join auto-generates a stable alias.
 
-## View Modes
+## Agents
 
 ```bash
-ats view
-ats view human
-ats view agent
-ats --view human whoami
-ats --view agent space join spaceship
+ats agents
+ats agents detect
+ats agents list
+ats agents enable --all
+ats agents enable --agent codex cursor
+ats agents disable --agent codex
+ats agents disable --all
+ats agents show codex
+ats agents config codex --enabled true
 ```
 
-## Agent Adapter
+Custom agent targets:
+
+```bash
+ats agents custom list
+ats agents custom add --name "ATS Agent Executor" --dir /absolute/path/to/skills
+ats agents custom update --id custom-abc123 --name "ATS Agent Executor v2"
+ats agents custom update --id custom-abc123 --dir /absolute/path/to/new-skills
+ats agents custom remove --id custom-abc123
+```
 
-Inspect adapter status:
+Notes:
+
+- `--dir` must be an absolute path.
+- `custom update` keeps the same target id (id is immutable).
+- `custom remove` is blocked if target is still registered.
+
+## Skills
 
 ```bash
-ats adapter status
+ats skills
+ats skills list
+ats skills install --all
+ats skills install --agent codex cursor
+ats skills install --dir /absolute/path/to/skills
+ats skills check
+ats skills update
+ats skills uninstall --all
+ats skills uninstall --agent codex
 ```
 
-Install for current active agent:
+## Background Service
 
 ```bash
-ats adapter --current
+ats service status
+ats service install
+ats service run
+ats service stop
+ats service stop --force
+ats service reinstall
+ats service reinstall --force
+ats service uninstall
 ```
 
-Install with explicit source:
+Auto-install policy per command:
 
 ```bash
-ats adapter --source ats/agent-transport-system --current
+ats --service-auto-install ask <command>
+ats --service-auto-install always <command>
+ats --service-auto-install never <command>
+```
+
+## View Modes
+
+```bash
+ats view
+ats view human
+ats view agent
+ats view auto --profile <profile-id-or-name>
+ats --view human whoami
+ats --view agent space join <space-id>
 ```
 
-## Development (Local Link)
+## Gateway URL Resolution
+
+Resolution order:
+
+1. `--gateway-url`
+2. `ATS_GATEWAY_URL`
+3. `~/.ats/config.json`
+4. default `https://gateway.ats.sh`
+
+Rules:
+
+- Use origin-only format: `scheme://host[:port]`
+- Do not include path/query/hash
+
+Persistence behavior:
+
+- `ats start` writes resolved gateway URL into `~/.ats/config.json`.
+- `ats-dev` uses local defaults and does not overwrite persisted gateway config.
+
+## Local Development Link
 
-Use local workspace build as global `ats`:
+Use workspace build as global `ats`/`ats-dev`:
 
 ```bash
-cd cli/ats-cli
+cd clients/ats-cli
 pnpm build
 pnpm link --global
 ```
 
-After code changes, rebuild:
+After code changes:
 
 ```bash
 pnpm build
@@ -136,5 +259,4 @@ If global bin is missing:
 
 ```bash
 pnpm setup
-source ~/.zshrc
 ```

package/dist/ats-dev.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+//#region src/ats-dev.ts
+const LOCAL_GATEWAY_URL = "http://localhost:8080";
+const LOCAL_AUTH_URL = "http://localhost:8788";
+const LOCAL_AUTH_CLIENT_ID = "ats-cli-dev";
+const DISABLE_GATEWAY_PERSIST = "1";
+if (!String(process.env.ATS_GATEWAY_URL ?? "").trim()) process.env.ATS_GATEWAY_URL = LOCAL_GATEWAY_URL;
+if (!String(process.env.ATS_AUTH_URL ?? "").trim()) process.env.ATS_AUTH_URL = LOCAL_AUTH_URL;
+if (!String(process.env.ATS_AUTH_CLIENT_ID ?? "").trim()) process.env.ATS_AUTH_CLIENT_ID = LOCAL_AUTH_CLIENT_ID;
+if (!String(process.env.ATS_DISABLE_GATEWAY_PERSIST ?? "").trim()) process.env.ATS_DISABLE_GATEWAY_PERSIST = DISABLE_GATEWAY_PERSIST;
+if (!String(process.env.ATS_DEV_MODE ?? "").trim()) process.env.ATS_DEV_MODE = "1";
+import("./ats.js").catch((error) => {
+	const message = error instanceof Error ? error.stack ?? error.message : String(error);
+	process.stderr.write(`${message}\n`);
+	process.exitCode = 1;
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=ats-dev.js.map

package/dist/ats-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ats-dev.js","names":[],"sources":["../src/ats-dev.ts"],"sourcesContent":["const LOCAL_GATEWAY_URL = \"http://localhost:8080\";\nconst LOCAL_AUTH_URL = \"http://localhost:8788\";\nconst LOCAL_AUTH_CLIENT_ID = \"ats-cli-dev\";\nconst DISABLE_GATEWAY_PERSIST = \"1\";\n\nif (!String(process.env.ATS_GATEWAY_URL ?? \"\").trim()) {\n  process.env.ATS_GATEWAY_URL = LOCAL_GATEWAY_URL;\n}\n\nif (!String(process.env.ATS_AUTH_URL ?? \"\").trim()) {\n  process.env.ATS_AUTH_URL = LOCAL_AUTH_URL;\n}\n\nif (!String(process.env.ATS_AUTH_CLIENT_ID ?? \"\").trim()) {\n  process.env.ATS_AUTH_CLIENT_ID = LOCAL_AUTH_CLIENT_ID;\n}\n\nif (!String(process.env.ATS_DISABLE_GATEWAY_PERSIST ?? \"\").trim()) {\n  process.env.ATS_DISABLE_GATEWAY_PERSIST = DISABLE_GATEWAY_PERSIST;\n}\n\nif (!String(process.env.ATS_DEV_MODE ?? \"\").trim()) {\n  process.env.ATS_DEV_MODE = \"1\";\n}\n\nimport(\"./ats\").catch((error: unknown) => {\n  const message =\n    error instanceof Error ? (error.stack ?? error.message) : String(error);\n  process.stderr.write(`${message}\\n`);\n  process.exitCode = 1;\n});\n"],"mappings":";;;AAAA,MAAM,oBAAoB;AAC1B,MAAM,iBAAiB;AACvB,MAAM,uBAAuB;AAC7B,MAAM,0BAA0B;AAEhC,IAAI,CAAC,OAAO,QAAQ,IAAI,mBAAmB,GAAG,CAAC,MAAM,CACnD,SAAQ,IAAI,kBAAkB;AAGhC,IAAI,CAAC,OAAO,QAAQ,IAAI,gBAAgB,GAAG,CAAC,MAAM,CAChD,SAAQ,IAAI,eAAe;AAG7B,IAAI,CAAC,OAAO,QAAQ,IAAI,sBAAsB,GAAG,CAAC,MAAM,CACtD,SAAQ,IAAI,qBAAqB;AAGnC,IAAI,CAAC,OAAO,QAAQ,IAAI,+BAA+B,GAAG,CAAC,MAAM,CAC/D,SAAQ,IAAI,8BAA8B;AAG5C,IAAI,CAAC,OAAO,QAAQ,IAAI,gBAAgB,GAAG,CAAC,MAAM,CAChD,SAAQ,IAAI,eAAe;AAG7B,OAAO,YAAS,OAAO,UAAmB;CACxC,MAAM,UACJ,iBAAiB,QAAS,MAAM,SAAS,MAAM,UAAW,OAAO,MAAM;AACzE,SAAQ,OAAO,MAAM,GAAG,QAAQ,IAAI;AACpC,SAAQ,WAAW;EACnB"}