@overaihq/cli 0.9.1 → 0.10.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -0
- package/dist/index.js +802 -451
- package/package.json +7 -2
package/README.md
CHANGED
|
@@ -48,6 +48,31 @@ clone/push/deploy. Runtime commands include `agent generate`, `data-stream
|
|
|
48
48
|
append|query`, `data-file upload|download|head`, `integration configure|config`,
|
|
49
49
|
and `printable-page render`; `overai help` shows their arguments.
|
|
50
50
|
|
|
51
|
+
## Working across organizations
|
|
52
|
+
|
|
53
|
+
Each backend and organization has an independent saved CLI session. Work in
|
|
54
|
+
separate workspace folders: commands automatically use the clone’s organization.
|
|
55
|
+
For commands outside a clone, use `OVERAI_ORG_ID=<orgId> overai <command>` or set
|
|
56
|
+
the shell variable. `org switch <orgId>` changes the machine-global default for
|
|
57
|
+
unscoped commands; it leaves other org sessions intact.
|
|
58
|
+
|
|
59
|
+
Missing org sessions are established from an eligible saved CLI login. SSO requires
|
|
60
|
+
browser authorization: run `OVERAI_ORG_ID=<orgId> overai signin`. Ordinary commands
|
|
61
|
+
never launch a browser. `whoami` shows the backend, org, identity, and selection
|
|
62
|
+
source; `org list` also indicates which orgs have saved sessions.
|
|
63
|
+
|
|
64
|
+
`signout` revokes the effective org’s CLI session. `signout --all` revokes all sessions
|
|
65
|
+
saved by this installation, across backends, without signing out browsers or other
|
|
66
|
+
machines. Failed revocations retain credentials for retry. Clone sync commands reject
|
|
67
|
+
an `OVERAI_ORG_ID` that disagrees with the clone.
|
|
68
|
+
|
|
69
|
+
Existing credentials migrate automatically. Credentials for different backends are
|
|
70
|
+
never exchanged between them; custom deployments remember `OVERAI_APP_URL` at signin.
|
|
71
|
+
One identity per backend is supported. An older CLI login whose legacy org switch
|
|
72
|
+
removed its CLI session tag needs browser sign-in before it can establish sibling
|
|
73
|
+
sessions. The new CLI requires a backend supporting `establishCliOrgSession` for
|
|
74
|
+
automatic org entry and never falls back to a destructive switch.
|
|
75
|
+
|
|
51
76
|
## Passing queries, JSON, and scripts
|
|
52
77
|
|
|
53
78
|
Arguments that carry a whole document rather than a scalar also accept `@<file>`
|