dev-orchestrator-cli 0.1.0 → 0.2.0

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.
Files changed (2) hide show
  1. package/README.md +19 -3
  2. package/package.json +7 -3
package/README.md CHANGED
@@ -8,6 +8,7 @@ entirely by the API's OpenAPI document (the single source of truth) — no .NET
8
8
  ```bash
9
9
  npm i -g dev-orchestrator-cli
10
10
  devorch --help
11
+ devorch --version # update later with: npm i -g dev-orchestrator-cli@latest
11
12
  ```
12
13
 
13
14
  The binary for your platform is delivered as an [`optionalDependencies`](https://docs.npmjs.com/cli/configuring-npm/package-json#optionaldependencies)
@@ -17,20 +18,35 @@ matches your machine. Do **not** install with `--no-optional` / `--omit=optional
17
18
  Supported platforms: `win32-x64`, `linux-x64`. (macOS `darwin-x64`/`darwin-arm64` ship once code-signed.)
18
19
 
19
20
  > .NET SDK users can instead use the NuGet channel: `dotnet tool install -g dev-orchestrator-cli`
20
- > (same `devorch` command).
21
+ > (same `devorch` command; update with `dotnet tool update -g dev-orchestrator-cli`).
21
22
 
22
23
  ## Usage
23
24
 
24
25
  ```bash
25
26
  devorch --base-url http://localhost:8700 health # or DEVORCH_API_BASE
26
- devorch login # caches a bearer token under ~/.devorch/
27
- devorch whoami
27
+ devorch login --oauth # browser sign-in (SSO/social); caches a session under ~/.devorch/
28
+ devorch whoami # who you are + how the session was obtained / when it expires
28
29
  devorch projects list
29
30
  devorch types project-status list
30
31
  ```
31
32
 
32
33
  `--base-url` defaults to `http://localhost:8700` (override via the flag or `DEVORCH_API_BASE`).
33
34
 
35
+ ### Signing in
36
+
37
+ | Command | Use when | Refresh |
38
+ |---|---|---|
39
+ | `devorch login --oauth` | Interactive: signs in through the browser with the API's identity provider (WorkOS AuthKit), the same flow as Claude Code's `/mcp authenticate`. `--no-browser` prints the URL instead. | Automatic (refresh token) |
40
+ | `devorch login --token -` | Headless: paste a Personal Access Token from **Account → API tokens** (`/app/account/tokens`) on stdin. `--token <value>` also works but lands in shell history. | None; lasts until it expires or is revoked |
41
+ | `devorch login --email … --password …` | Local email + password accounts. | Automatic (refresh token) |
42
+ | `DEVORCH_API_TOKEN=<pat>` (env) | CI: no cache file, wins over any cached session. | None |
43
+
44
+ Sessions are cached per base URL in `~/.devorch/token.json` (`DEVORCH_HOME` relocates the folder).
45
+ `devorch mcp serve` (stdio) uses the same cache and refreshes it, so a long-running MCP server outlives
46
+ the access token. OAuth client registrations are cached in `~/.devorch/oauth-clients.json`; set
47
+ `DEVORCH_OAUTH_CLIENT_ID` (+ `--port`) to use a pre-registered public client instead of Dynamic Client
48
+ Registration.
49
+
34
50
  ## How it's built
35
51
 
36
52
  `run.js` (this package's `bin`) detects `process.platform`/`process.arch`, resolves the matching
package/package.json CHANGED
@@ -1,8 +1,12 @@
1
1
  {
2
2
  "name": "dev-orchestrator-cli",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "Dev Orchestrator CLI (devorch) — a self-contained .NET client driven by the API's OpenAPI document. Installs the prebuilt binary for your platform via optionalDependencies.",
5
5
  "license": "UNLICENSED",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/traviswaldorf/dev-orchestrator-api.git"
9
+ },
6
10
  "bin": {
7
11
  "devorch": "run.js"
8
12
  },
@@ -11,8 +15,8 @@
11
15
  "README.md"
12
16
  ],
13
17
  "optionalDependencies": {
14
- "@devorch/cli-win32-x64": "0.1.0",
15
- "@devorch/cli-linux-x64": "0.1.0"
18
+ "@devorch/cli-win32-x64": "0.2.0",
19
+ "@devorch/cli-linux-x64": "0.2.0"
16
20
  },
17
21
  "engines": {
18
22
  "node": ">=18"