iterate 0.2.5 → 0.2.6

package/README.md

@@ -1,58 +1,52 @@
 # iterate
 
-⚠️⚠️⚠️ Coming soon! `npx iterate` is a work-in-progress CLI for managing [iterate.com](https://iterate.com) agents ⚠️⚠️⚠️
-
 CLI for Iterate.
 
-Runs as a thin bootstrapper that:
+`npx iterate` opens the Iterate chat terminal UI. It is equivalent to
+`npx iterate chat`.
 
-1. Resolves an `iterate/iterate` checkout.
-2. Clones/install deps when needed.
-3. Loads `apps/os/backend/trpc/root.ts` from that checkout.
-4. Exposes commands like `iterate os ...` and `iterate whoami`.
+The package also runs as a thin bootstrapper: inside this repo it delegates to
+the local `packages/iterate` source, and from npm it runs the published build.
 
 ## Requirements
 
 - Node `>=22`
-- `git`
-- `pnpm` or `corepack`
+- Bun, for the current OpenTUI-based chat terminal runtime
 
 ## Quick start
 
 Run without installing globally:
 
 ```bash
-npx iterate --help
+npx iterate
 ```
 
-Initial setup (writes auth + launcher config):
+If you are not logged in yet, `iterate chat` starts the browser OAuth flow. The
+auth flow asks for project access and can create your first organization and
+project before returning to the CLI.
 
 ```bash
-npx iterate setup \
-  --os-base-url https://dev-yourname-os.dev.iterate.com \
-  --daemon-base-url http://localhost:3001 \
-  --admin-password-env-var-name SERVICE_AUTH_TOKEN \
-  --user-email dev-yourname@iterate.com \
-  --scope global
+npx iterate chat
 ```
 
-Then run commands:
+For help and other commands:
 
 ```bash
-npx iterate whoami
-npx iterate os project list
+npx iterate --help
+npx iterate login
+npx iterate orgs list
+npx iterate config list
 ```
 
 ## Commands
 
-- `iterate setup` - configure auth + launcher defaults
-- `iterate doctor` - print resolved config/runtime info
-- `iterate install` - force clone/install for resolved checkout
-- `iterate whoami`
+- `iterate` - open chat
+- `iterate chat` - open the Iterate agent chat terminal UI
+- `iterate login` - authenticate with browser-based OAuth
+- `iterate logout` - remove the stored session for the current config
+- `iterate orgs list`
+- `iterate config ...`
 - `iterate os ...`
-- `iterate daemon ...`
-
-`setup --scope global` writes auth + launcher values into `global`; `setup --scope workspace` writes them into `workspaces[process.cwd()]`.
 
 ## Config file
 
@@ -64,71 +58,40 @@ Config shape:
 
 ```json
 {
-  "global": {
-    "repoPath": "~/.local/share/iterate/repo",
-    "repoRef": "main",
-    "repoUrl": "https://github.com/iterate/iterate.git",
-    "autoInstall": true
+  "configs": {
+    "default": {
+      "osBaseUrl": "https://os.iterate.com",
+      "authBaseUrl": "https://auth.iterate.com",
+      "defaultProject": "my-project"
+    },
+    "dev": {
+      "osBaseUrl": "http://localhost:54896",
+      "authBaseUrl": "http://localhost:7101"
+    }
   },
+  "default": "default",
   "workspaces": {
-    "/absolute/workspace/path": {
-      "osBaseUrl": "https://dev-yourname-os.dev.iterate.com",
-      "daemonBaseUrl": "http://localhost:3001",
-      "adminPasswordEnvVarName": "SERVICE_AUTH_TOKEN",
-      "userEmail": "dev-yourname@iterate.com"
-    }
+    "/absolute/workspace/path": "dev"
   }
 }
 ```
 
-Merge precedence is shallow:
-
-`global` -> `workspaces[process.cwd()]`
-
-## Repo checkout resolution
-
-`repoPath` resolution order:
-
-1. `ITERATE_REPO_DIR`
-2. `workspaces[process.cwd()].repoPath`
-3. `global.repoPath`
-4. nearest parent directory containing `.git`, `pnpm-workspace.yaml`, and `apps/os/backend/trpc/root.ts`
-5. default managed checkout path `${XDG_DATA_HOME:-~/.local/share}/iterate/repo`
-
-`repoPath` shortcuts in `setup`:
-
-- `local` - nearest local iterate checkout
-- `managed` - default managed checkout path
-
-Environment overrides:
-
-- `ITERATE_REPO_DIR`
-- `ITERATE_REPO_REF`
-- `ITERATE_REPO_URL`
-- `ITERATE_AUTO_INSTALL` (`1/true` or `0/false`)
+Config resolution priority: `--config` flag > workspace match (walk up from cwd) > `default` key > single-config auto-select.
 
 ## Local iterate dev
 
-If you run inside an `iterate/iterate` clone, the CLI auto-detects it. In that mode, default `autoInstall` is `false`.
-
-You can pin explicitly:
-
-```bash
-npx iterate setup \
-  --os-base-url https://dev-yourname-os.dev.iterate.com \
-  --daemon-base-url http://localhost:3001 \
-  --admin-password-env-var-name SERVICE_AUTH_TOKEN \
-  --user-email dev-yourname@iterate.com \
-  --scope workspace
-```
+If you run inside an `iterate/iterate` clone, the CLI auto-detects it and
+delegates to the local source instead of the published build.
 
 ## Publishing (maintainers)
 
 From repo root:
 
 ```bash
+pnpm --filter ./packages/iterate build
 pnpm --filter ./packages/iterate typecheck
-pnpm eslint packages/iterate/bin/iterate.js
-pnpm prettier --check packages/iterate
+pnpm --filter ./packages/iterate test
+pnpm exec oxlint packages/iterate/src/cli.ts packages/iterate/src/cli.test.ts
+pnpm exec oxfmt --check packages/iterate
 pnpm --filter ./packages/iterate publish --access public
 ```

package/bin/iterate.js

@@ -45,7 +45,7 @@ const findLocalModule = () => {
       // Prefer TS source in monorepo dev, fall back to dist
       const repoSrc = join(repoPkg, "src/index.ts");
       if (existsSync(repoSrc)) return repoSrc;
-      const repoDist = join(repoPkg, "dist/index.js");
+      const repoDist = join(repoPkg, "dist/index.mjs");
       if (existsSync(repoDist)) return repoDist;
     }
   }
@@ -56,7 +56,7 @@ const findLocalModule = () => {
     const nmScript = join(nmRoot, "node_modules/.bin/iterate");
     if (existsSync(nmScript) && realpathSync(nmScript) !== selfReal) {
       // Published package — use dist
-      const nmDist = join(nmRoot, "node_modules/iterate/dist/index.js");
+      const nmDist = join(nmRoot, "node_modules/iterate/dist/index.mjs");
       if (existsSync(nmDist)) return nmDist;
     }
   }
@@ -70,9 +70,9 @@ if (localModule) {
   await runCli();
 } else {
   // No delegation — run our own copy.
-  // In monorepo dev: src/index.ts exists. Published: dist/index.js exists.
+  // In monorepo dev: src/index.ts exists. Published: dist/index.mjs exists.
   const srcPath = join(pkgRoot, "src/index.ts");
-  const distPath = join(pkgRoot, "dist/index.js");
+  const distPath = join(pkgRoot, "dist/index.mjs");
   const modulePath = existsSync(srcPath) ? srcPath : distPath;
   const { runCli } = await import(modulePath);
   await runCli();