nowrun 2.0.1__tar.gz → 2.0.2__tar.gz

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 (35) hide show
  1. {nowrun-2.0.1 → nowrun-2.0.2}/PKG-INFO +13 -12
  2. {nowrun-2.0.1 → nowrun-2.0.2}/README.md +12 -11
  3. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/cli.py +11 -10
  4. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/inspect.py +1 -2
  5. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/config.py +23 -19
  6. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/skill/SKILL.md +20 -24
  7. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/PKG-INFO +13 -12
  8. {nowrun-2.0.1 → nowrun-2.0.2}/setup.py +1 -1
  9. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/__init__.py +0 -0
  10. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/__main__.py +0 -0
  11. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/apk.py +0 -0
  12. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/appmeta.py +0 -0
  13. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/client.py +0 -0
  14. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/__init__.py +0 -0
  15. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/admin.py +0 -0
  16. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/app.py +0 -0
  17. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/deploy.py +0 -0
  18. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/legacy.py +0 -0
  19. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/login.py +0 -0
  20. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/mcp.py +0 -0
  21. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/mode.py +0 -0
  22. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/setup.py +0 -0
  23. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/skill.py +0 -0
  24. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/update.py +0 -0
  25. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/validate.py +0 -0
  26. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/fields.py +0 -0
  27. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/output.py +0 -0
  28. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/passthrough.py +0 -0
  29. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/upload.py +0 -0
  30. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/SOURCES.txt +0 -0
  31. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/dependency_links.txt +0 -0
  32. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/entry_points.txt +0 -0
  33. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/requires.txt +0 -0
  34. {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/top_level.txt +0 -0
  35. {nowrun-2.0.1 → nowrun-2.0.2}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: nowrun
3
- Version: 2.0.1
3
+ Version: 2.0.2
4
4
  Summary: CLI to deploy and manage Android and HTML5 apps on nowrun.
5
5
  Home-page: https://nowrun.io
6
6
  Author: nowrun
@@ -14,12 +14,12 @@ Description-Content-Type: text/markdown
14
14
 
15
15
  # nowrun CLI
16
16
 
17
- Deploy Android and HTML5 apps to a live URL - driven by your AI coding agent.
17
+ Publish Android apps so people can run them inside ChatGPT - driven by your AI coding agent.
18
18
 
19
- `nowrun` publishes Android and HTML5 apps to [nowrun](https://nowrun.io) and streams each at a
20
- URL anyone can open in a browser, no install. You don't run deploy commands by hand: you set
21
- the CLI up once, then tell your agent to ship. Android works with any engine that builds an APK
22
- (native, Unity, Godot, Unreal); HTML5 games deploy as a zipped bundle.
19
+ `nowrun` publishes Android apps to [nowrun](https://nowrun.io) so people can run them inside
20
+ ChatGPT (and other AI assistants that connect to nowrun) - streamed into the conversation, no
21
+ install and no app store. You don't run deploy commands by hand: you set the CLI up once, then
22
+ tell your agent to ship. Works with any engine that builds an APK (native, Unity, Godot, Unreal).
23
23
 
24
24
  ## Quickstart
25
25
 
@@ -38,10 +38,10 @@ copy or paste. (`nowrun update` refreshes it later; `nowrun logout` signs out.)
38
38
 
39
39
  **3. Tell your agent.** Open your AI coding tool in your project and give it this prompt:
40
40
 
41
- > Deploy my app to nowrun and give me the live public URL using the nowrun CLI. If you need the steps, read https://nowrun.io/docs/skill.md
41
+ > Deploy my app to nowrun so people can run it in ChatGPT using the nowrun CLI. If you need the steps, read https://nowrun.io/docs/skill.md
42
42
 
43
- Your agent creates (or reuses) the app, uploads the build, deploys it, and hands back the live
44
- URL. That's the whole flow.
43
+ Your agent creates (or reuses) the app, uploads the build, and deploys it - and once it's live,
44
+ people can run it inside ChatGPT. That's the whole flow.
45
45
 
46
46
  ## What your agent runs for you
47
47
 
@@ -56,13 +56,14 @@ They're here for reference (and the occasional manual run):
56
56
  | `nowrun app list` / `nowrun app show` | list your apps / show one, with its visibility and readiness |
57
57
  | `nowrun inspect app.apk` | read a build's package + version, no Android SDK needed |
58
58
  | `nowrun validate` | check what's missing before deploying |
59
- | `nowrun deploy -f app.apk` | deploy a build and get its live link (version read from the APK; `--wait` blocks until live) |
59
+ | `nowrun deploy -f app.apk` | deploy a build so it's runnable in ChatGPT (version read from the APK; `--wait` blocks until live) |
60
60
  | `nowrun status -s <submission_id>` | poll until it's live |
61
61
  | `nowrun help --json` | full command list + workflow (what the agent reads) |
62
62
 
63
63
  `deploy` reads the build's package/version and **refuses to deploy a build whose package
64
- doesn't match the app**, so you never publish to the wrong place. Add `--json` (in any
65
- position) to any command for machine-readable output.
64
+ doesn't match the app**, so you never publish to the wrong place. It also **refuses a version
65
+ code that isn't higher than the one currently live** (like the Play Store), so you can't ship a
66
+ downgrade. Add `--json` (in any position) to any command for machine-readable output.
66
67
 
67
68
  New apps are private; a nowrun admin decides which deployed apps are listed in ChatGPT.
68
69
  You stay signed in: the CLI refreshes its session automatically (for 30 days after last use).
@@ -1,11 +1,11 @@
1
1
  # nowrun CLI
2
2
 
3
- Deploy Android and HTML5 apps to a live URL - driven by your AI coding agent.
3
+ Publish Android apps so people can run them inside ChatGPT - driven by your AI coding agent.
4
4
 
5
- `nowrun` publishes Android and HTML5 apps to [nowrun](https://nowrun.io) and streams each at a
6
- URL anyone can open in a browser, no install. You don't run deploy commands by hand: you set
7
- the CLI up once, then tell your agent to ship. Android works with any engine that builds an APK
8
- (native, Unity, Godot, Unreal); HTML5 games deploy as a zipped bundle.
5
+ `nowrun` publishes Android apps to [nowrun](https://nowrun.io) so people can run them inside
6
+ ChatGPT (and other AI assistants that connect to nowrun) - streamed into the conversation, no
7
+ install and no app store. You don't run deploy commands by hand: you set the CLI up once, then
8
+ tell your agent to ship. Works with any engine that builds an APK (native, Unity, Godot, Unreal).
9
9
 
10
10
  ## Quickstart
11
11
 
@@ -24,10 +24,10 @@ copy or paste. (`nowrun update` refreshes it later; `nowrun logout` signs out.)
24
24
 
25
25
  **3. Tell your agent.** Open your AI coding tool in your project and give it this prompt:
26
26
 
27
- > Deploy my app to nowrun and give me the live public URL using the nowrun CLI. If you need the steps, read https://nowrun.io/docs/skill.md
27
+ > Deploy my app to nowrun so people can run it in ChatGPT using the nowrun CLI. If you need the steps, read https://nowrun.io/docs/skill.md
28
28
 
29
- Your agent creates (or reuses) the app, uploads the build, deploys it, and hands back the live
30
- URL. That's the whole flow.
29
+ Your agent creates (or reuses) the app, uploads the build, and deploys it - and once it's live,
30
+ people can run it inside ChatGPT. That's the whole flow.
31
31
 
32
32
  ## What your agent runs for you
33
33
 
@@ -42,13 +42,14 @@ They're here for reference (and the occasional manual run):
42
42
  | `nowrun app list` / `nowrun app show` | list your apps / show one, with its visibility and readiness |
43
43
  | `nowrun inspect app.apk` | read a build's package + version, no Android SDK needed |
44
44
  | `nowrun validate` | check what's missing before deploying |
45
- | `nowrun deploy -f app.apk` | deploy a build and get its live link (version read from the APK; `--wait` blocks until live) |
45
+ | `nowrun deploy -f app.apk` | deploy a build so it's runnable in ChatGPT (version read from the APK; `--wait` blocks until live) |
46
46
  | `nowrun status -s <submission_id>` | poll until it's live |
47
47
  | `nowrun help --json` | full command list + workflow (what the agent reads) |
48
48
 
49
49
  `deploy` reads the build's package/version and **refuses to deploy a build whose package
50
- doesn't match the app**, so you never publish to the wrong place. Add `--json` (in any
51
- position) to any command for machine-readable output.
50
+ doesn't match the app**, so you never publish to the wrong place. It also **refuses a version
51
+ code that isn't higher than the one currently live** (like the Play Store), so you can't ship a
52
+ downgrade. Add `--json` (in any position) to any command for machine-readable output.
52
53
 
53
54
  New apps are private; a nowrun admin decides which deployed apps are listed in ChatGPT.
54
55
  You stay signed in: the CLI refreshes its session automatically (for 30 days after last use).
@@ -57,7 +57,7 @@ WORKFLOW = [
57
57
  "app create --title <t> ... # create an app with all its metadata (or 'app list' to reuse one)",
58
58
  "use <app_id> # bind this workspace to an app (optional)",
59
59
  "validate # check what's missing before deploying",
60
- "deploy -f app.apk ... # upload + deploy a build and get the live link",
60
+ "deploy -f app.apk ... # upload + deploy a build (runnable in ChatGPT once live)",
61
61
  "status # poll until it's live",
62
62
  "mode [admin|personal] # nowrun admins: show/switch mode (admin = nowrun-managed apps, audited)",
63
63
  "admin apps list ... # nowrun admins (admin mode): review apps, set-public/disable/..., users, audit",
@@ -112,8 +112,9 @@ def build_manifest(parser):
112
112
  tree = _describe(parser, 'nowrun', 'nowrun publishing CLI')
113
113
  return {
114
114
  "tool": "nowrun",
115
- "description": "Deploy Android and HTML5 apps to nowrun. Sign in once with `nowrun login`. "
116
- "Every command supports --json for machine-readable output.",
115
+ "description": "Deploy Android apps to nowrun so people can run them inside ChatGPT. "
116
+ "Sign in once with `nowrun login`. Every command supports --json for "
117
+ "machine-readable output.",
117
118
  "workflow": WORKFLOW,
118
119
  "commands": tree.get("subcommands", []),
119
120
  "global_options": tree.get("args", []),
@@ -248,7 +249,7 @@ def build_parser():
248
249
  'flags override it. In admin mode this creates a nowrun-managed app.')
249
250
  app_create_parser.add_argument('-t', '--title', type=str, help='App title (required)')
250
251
  app_create_parser.add_argument('--type', dest='game_type', choices=['android', 'h5'],
251
- help='App type: android (default) or h5 (HTML5 web game)')
252
+ help='App type (default: android)')
252
253
  app_create_parser.add_argument('-p', '--package', dest='app_pkg_name', type=str,
253
254
  help='Android package name (required for --type android; or use --from-apk)')
254
255
  app_create_parser.add_argument('-f', '--from-apk', dest='from_apk', type=str,
@@ -279,17 +280,17 @@ def build_parser():
279
280
  app_delete_parser.add_argument('-y', '--yes', action='store_true', help='Skip the confirmation prompt (for scripts/agents)')
280
281
 
281
282
  # deploy
282
- deploy_parser = subparsers.add_parser('deploy', help='Deploy a build and get its live link', formatter_class=fmt)
283
+ deploy_parser = subparsers.add_parser('deploy', help='Deploy a build (runnable in ChatGPT once live)', formatter_class=fmt)
283
284
  deploy_parser.add_argument('-a', '--app-id', '--app_id', dest='app_id', type=str, help="The app's app_id from `app create` / `app list` (default: workspace app)", required=False)
284
285
  deploy_parser.add_argument('-f', '--file_path', type=str,
285
- help='Path to the build: an .apk/.zip for Android, or a .zip web bundle for HTML5',
286
+ help='Path to the build: an .apk or .zip for Android',
286
287
  required=True)
287
288
  deploy_parser.add_argument('-av', '--apk_version', type=str,
288
289
  help='Version name (Android; auto-read from the .apk if omitted)', required=False)
289
290
  deploy_parser.add_argument('-vc', '--version_code', type=int,
290
291
  help='Version code (Android; auto-read from the .apk if omitted)', required=False)
291
292
  deploy_parser.add_argument('--wait', action='store_true',
292
- help='Block until the deployment is live (or fails) and print the live URL')
293
+ help='Block until the deployment is live (or fails)')
293
294
  deploy_parser.add_argument('--timeout', type=int, default=900,
294
295
  help='With --wait, give up after this many seconds (default: 900)')
295
296
 
@@ -378,7 +379,7 @@ def _admin_parsers(subparsers):
378
379
  'set-private': 'Remove apps from the catalog listing',
379
380
  'disable': 'Disable apps: out of the catalog, read-only, no deploys (asks to confirm)',
380
381
  'enable': 'Re-enable disabled apps',
381
- 'unpublish': 'Take the live deployment down (private, live URL cleared; asks to confirm)',
382
+ 'unpublish': 'Take the live deployment down (private; removed from ChatGPT; asks to confirm)',
382
383
  'remove': 'Remove any apps: out of every list and the catalog, package freed, record kept (asks to confirm)',
383
384
  'delete': 'PERMANENTLY erase nowrun-managed apps and their builds - cannot be undone (asks to confirm)',
384
385
  }
@@ -525,8 +526,8 @@ def main():
525
526
  "publisher tokens are no longer used - ignoring -t/--token and signing in with "
526
527
  "`nowrun login` (browser). Update this command to `nowrun login`.")
527
528
  # login is strict about the target environment: with --host, use it; WITHOUT --host,
528
- # always reset to prod - never inherit a host left over from an earlier `--host qa1`
529
- # (which would silently sign you into the wrong environment).
529
+ # always reset to prod - never inherit a host left over from an earlier
530
+ # `--host https://qa.nowrun.io` (which would silently sign you into the wrong environment).
530
531
  if getattr(args, 'host', None):
531
532
  config.set_host(config.resolve_host(args.host))
532
533
  else:
@@ -18,8 +18,7 @@ def inspect(path):
18
18
  if not meta or not meta.get("package"):
19
19
  emit_error(
20
20
  "Could not read Android metadata from this file.",
21
- hint="Pass an .apk, or an Android .zip that contains one. HTML5 .zip web "
22
- "bundles have no Android manifest, so there's nothing to read.")
21
+ hint="Pass an .apk, or an Android .zip that contains one.")
23
22
  return
24
23
  emit_success(meta, human=_print_inspect)
25
24
 
@@ -29,27 +29,17 @@ WORKSPACE_FILE = 'nowrun.json' # per-project app binding (stays in the cwd)
29
29
 
30
30
  # nowrun-backend topology: the API is served at DOMAIN/api, the dashboard at DOMAIN/console.
31
31
  PROD_HOST = 'https://nowrun.io/api'
32
- QA_HOST = 'https://qa.nowrun.io/api'
33
- DEV_HOST = 'https://dev.nowrun.io/api'
34
32
  LOCAL_HOST = 'http://localhost:3000/api'
35
33
 
36
34
  # Default to prod. Point at another environment with the internal `--host` flag
37
- # (`nowrun login --host qa`), which accepts a shorthand below or a full URL.
35
+ # (`nowrun login --host https://qa.nowrun.io`), which takes a full URL or a bare host -
36
+ # there are no named shorthands. See resolve_host.
38
37
  DEFAULT_HOST = PROD_HOST
39
38
 
40
- # Shorthand -> API host, and API host -> console (dashboard) URL where `nowrun login`
41
- # opens the browser. prod -> nowrun.io, qa / qa1 -> qa.nowrun.io, dev -> dev.nowrun.io.
42
- _HOST_ALIASES = {
43
- 'prod': PROD_HOST,
44
- 'qa': QA_HOST,
45
- 'qa1': QA_HOST,
46
- 'dev': DEV_HOST,
47
- 'local': LOCAL_HOST,
48
- }
39
+ # API host -> console (dashboard) URL where `nowrun login` opens the browser. Only the
40
+ # exceptions live here: local serves its dashboard on a different port. Every other
41
+ # host's console is DOMAIN/console, derived in console_url().
49
42
  _CONSOLE_URLS = {
50
- PROD_HOST: 'https://nowrun.io/console',
51
- QA_HOST: 'https://qa.nowrun.io/console',
52
- DEV_HOST: 'https://dev.nowrun.io/console',
53
43
  LOCAL_HOST: 'http://localhost:3002',
54
44
  }
55
45
 
@@ -86,12 +76,26 @@ def ui_host():
86
76
 
87
77
 
88
78
  def resolve_host(value):
89
- """Map a --host value to a full API host URL. Accepts a full URL, or a shorthand
90
- (prod / qa / qa1 / dev / local). Returns None for an empty value."""
79
+ """Map a --host value to a full API host URL. Takes a full URL
80
+ ("https://qa.nowrun.io") or a bare host ("qa.nowrun.io", "localhost:3000") -
81
+ there are no named shorthands. Returns None for an empty value.
82
+
83
+ The API lives at DOMAIN/api and the client appends API paths (/v2/...) to the
84
+ host verbatim, so the resolved host MUST end in /api - otherwise every call
85
+ hits the wrong path and auth looks broken. So we normalise: add a scheme for a
86
+ bare host (http for localhost, else https), then the /api suffix if missing.
87
+ """
91
88
  if not value:
92
89
  return None
93
- v = value.strip()
94
- return _HOST_ALIASES.get(v.lower(), v)
90
+ v = value.strip().rstrip('/')
91
+ if not v:
92
+ return None
93
+ if not (v.startswith('http://') or v.startswith('https://')):
94
+ scheme = 'http' if v.split(':', 1)[0] in ('localhost', '127.0.0.1') else 'https'
95
+ v = f'{scheme}://{v}'
96
+ if not v.endswith('/api'):
97
+ v = f'{v}/api'
98
+ return v
95
99
 
96
100
 
97
101
  def _cache_obj():
@@ -1,14 +1,14 @@
1
1
  ---
2
2
  name: nowrun-publishing
3
- description: Deploy and manage Android and HTML5 (web) apps on nowrun using the `nowrun` CLI. Use whenever the user wants to create an app, upload a build, deploy it to a live link, check status/readiness, or update its listing metadata.
3
+ description: Deploy and manage Android apps on nowrun using the `nowrun` CLI. Use whenever the user wants to create an app, upload a build, deploy it so people can run it in ChatGPT, check status/readiness, or update its listing metadata.
4
4
  ---
5
5
 
6
6
  # Publishing to nowrun with the `nowrun` CLI
7
7
 
8
- The `nowrun` CLI deploys **Android** apps (compiled `.apk`/`.zip`) and **HTML5** web
9
- games (a `.zip` web bundle) to nowrun. The human signs in once with `nowrun login`
10
- (browser); you operate the CLI, and the human handles account setup and app configuration
11
- in the dashboard.
8
+ The `nowrun` CLI deploys **Android** apps (a compiled `.apk`, or an `.apk` inside a `.zip`)
9
+ to nowrun, so people can run them inside ChatGPT (and other AI assistants that connect to
10
+ nowrun). The human signs in once with `nowrun login` (browser); you operate the CLI, and the
11
+ human handles account setup and app configuration in the dashboard.
12
12
 
13
13
  ## First: discover the tool (don't guess commands)
14
14
 
@@ -85,8 +85,8 @@ Follow this sequence end to end; each step is expanded in the sections below.
85
85
  the flag that sets it). For Android, also verify the binary (package matches,
86
86
  release-signed) - see "Android builds" below.
87
87
  5. **Deploy** - `nowrun deploy -f <build> [-av <name> -vc <code>]`, then poll
88
- `nowrun status -s <submission_id>` until it returns the live URL (or pass `--wait`).
89
- Share the URL. `nowrun status` (no `-s`) shows what's live and what's building;
88
+ `nowrun status -s <submission_id>` until it goes live (or pass `--wait`). Once live, the
89
+ app is runnable in ChatGPT. `nowrun status` (no `-s`) shows what's live and what's building;
90
90
  `nowrun cancel` stops a build in progress so you can start another.
91
91
  6. **Delete (end of life)** - `nowrun app delete -a <app_id> --yes` permanently removes the
92
92
  app and frees a plan app slot. Destructive and irreversible: only on an explicit user
@@ -106,12 +106,9 @@ nowrun app list --json # otherwise find an existing app whose app_pkg_name m
106
106
  `nowrun use <app_id>` (writes nowrun.json).
107
107
  - **No match:** create it with all its metadata (see "App metadata" below); this
108
108
  **auto-binds** (writes nowrun.json):
109
- - **Android:** `nowrun app create --title "My App" -p com.foo.bar ...` (or
110
- `--from-apk app.apk` to read the package name - and, without `--icon`, the launcher
111
- icon - straight from the build instead of `-p`).
112
- - **HTML5:** `nowrun app create --title "My Game" --type h5 ...` - no package; it is
113
- synthesized. (HTML5 apps won't appear in `app list` by package, so reuse the `app_id`
114
- from nowrun.json / `app list` rather than matching a package name.)
109
+ `nowrun app create --title "My App" -p com.foo.bar ...` (or `--from-apk app.apk` to read
110
+ the package name - and, without `--icon`, the launcher icon - straight from the build
111
+ instead of `-p`).
115
112
 
116
113
  After this, `nowrun.json` holds the app_id and `deploy`/`status`/`validate` default to it.
117
114
  Never run `app create` for a package that already has an app.
@@ -178,15 +175,14 @@ human; only a nowrun admin can re-enable it.
178
175
  out of an Android build. `validate` flags a missing icon; set one before deploying so the
179
176
  live app looks complete. (`--from-apk` is best-effort - if the build has no resolvable
180
177
  raster icon it tells you, and you provide an image instead.)
181
- - **Deploy:**
182
- - **Android:** `nowrun deploy -f app.apk` - the version name and code are read from the
183
- APK automatically. Pass `-av <name> -vc <code>` only to override; if they disagree with
184
- the APK the CLI warns you. First verify the binary (see "Android builds" below).
185
- - **HTML5:** `nowrun deploy -f game.zip` (a web bundle; no version name/code - HTML5 has none).
186
-
187
- Uploads the build and deploys it, then poll `nowrun status -s <submission_id>` until it
188
- returns a live URL. Share the URL. Add `--wait` to have `deploy` block and return the live
189
- URL itself (no polling loop needed).
178
+ - **Deploy:** `nowrun deploy -f app.apk` - the version name and code are read from the APK
179
+ automatically. Pass `-av <name> -vc <code>` only to override; if they disagree with the APK
180
+ the CLI warns you. First verify the binary (see "Android builds" below). The version code must
181
+ be higher than the currently live one (like the Play Store) or the deploy is rejected.
182
+
183
+ Uploads the build and deploys it, then poll `nowrun status -s <submission_id>` until it goes
184
+ live; once live, the app is runnable in ChatGPT. Add `--wait` to have `deploy` block until it
185
+ settles (no polling loop needed).
190
186
  If deploy fails with error code `CARD_NOT_VERIFIED` (HTTP 402), the human hasn't
191
187
  verified a payment card yet - tell them to add one in the nowrun dashboard (the error
192
188
  message includes the link), then retry. This is required only once, before the first deploy.
@@ -205,7 +201,7 @@ human; only a nowrun admin can re-enable it.
205
201
  `nowrun validate` covers the app's title and icon, NOT the binary - so before an **Android**
206
202
  deploy (`.apk` or `.zip`), check the actual file yourself. These checks use the Android SDK
207
203
  build-tools (`aapt`/`aapt2`, `apksigner`); if they aren't installed, say so instead of
208
- silently skipping. (HTML5 `.zip` web bundles are exempt - they have no package name or signing.)
204
+ silently skipping.
209
205
 
210
206
  1. **Package name matches the bound app.** The APK's package must equal the app's package
211
207
  name (`app_pkg_name` from `nowrun app list`, i.e. what you bound with `nowrun use`). A
@@ -262,7 +258,7 @@ Common cases:
262
258
  ## Rules & gotchas
263
259
 
264
260
  - **Deploy is async.** After `deploy`, poll `status`; `job_status: progress` means the
265
- cloud build is running; `success` yields the live URL.
261
+ cloud build is running; `success` means it's live and runnable in ChatGPT.
266
262
  - **`submitted` means "in review," not failed.** A 429 (`DEPLOY_IN_PROGRESS`) means a
267
263
  deployment is already running: poll `nowrun status`, or `nowrun cancel` and redeploy - don't retry.
268
264
  - **There is one deployment per app, one build at a time.** `nowrun deploy` publishes to a
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: nowrun
3
- Version: 2.0.1
3
+ Version: 2.0.2
4
4
  Summary: CLI to deploy and manage Android and HTML5 apps on nowrun.
5
5
  Home-page: https://nowrun.io
6
6
  Author: nowrun
@@ -14,12 +14,12 @@ Description-Content-Type: text/markdown
14
14
 
15
15
  # nowrun CLI
16
16
 
17
- Deploy Android and HTML5 apps to a live URL - driven by your AI coding agent.
17
+ Publish Android apps so people can run them inside ChatGPT - driven by your AI coding agent.
18
18
 
19
- `nowrun` publishes Android and HTML5 apps to [nowrun](https://nowrun.io) and streams each at a
20
- URL anyone can open in a browser, no install. You don't run deploy commands by hand: you set
21
- the CLI up once, then tell your agent to ship. Android works with any engine that builds an APK
22
- (native, Unity, Godot, Unreal); HTML5 games deploy as a zipped bundle.
19
+ `nowrun` publishes Android apps to [nowrun](https://nowrun.io) so people can run them inside
20
+ ChatGPT (and other AI assistants that connect to nowrun) - streamed into the conversation, no
21
+ install and no app store. You don't run deploy commands by hand: you set the CLI up once, then
22
+ tell your agent to ship. Works with any engine that builds an APK (native, Unity, Godot, Unreal).
23
23
 
24
24
  ## Quickstart
25
25
 
@@ -38,10 +38,10 @@ copy or paste. (`nowrun update` refreshes it later; `nowrun logout` signs out.)
38
38
 
39
39
  **3. Tell your agent.** Open your AI coding tool in your project and give it this prompt:
40
40
 
41
- > Deploy my app to nowrun and give me the live public URL using the nowrun CLI. If you need the steps, read https://nowrun.io/docs/skill.md
41
+ > Deploy my app to nowrun so people can run it in ChatGPT using the nowrun CLI. If you need the steps, read https://nowrun.io/docs/skill.md
42
42
 
43
- Your agent creates (or reuses) the app, uploads the build, deploys it, and hands back the live
44
- URL. That's the whole flow.
43
+ Your agent creates (or reuses) the app, uploads the build, and deploys it - and once it's live,
44
+ people can run it inside ChatGPT. That's the whole flow.
45
45
 
46
46
  ## What your agent runs for you
47
47
 
@@ -56,13 +56,14 @@ They're here for reference (and the occasional manual run):
56
56
  | `nowrun app list` / `nowrun app show` | list your apps / show one, with its visibility and readiness |
57
57
  | `nowrun inspect app.apk` | read a build's package + version, no Android SDK needed |
58
58
  | `nowrun validate` | check what's missing before deploying |
59
- | `nowrun deploy -f app.apk` | deploy a build and get its live link (version read from the APK; `--wait` blocks until live) |
59
+ | `nowrun deploy -f app.apk` | deploy a build so it's runnable in ChatGPT (version read from the APK; `--wait` blocks until live) |
60
60
  | `nowrun status -s <submission_id>` | poll until it's live |
61
61
  | `nowrun help --json` | full command list + workflow (what the agent reads) |
62
62
 
63
63
  `deploy` reads the build's package/version and **refuses to deploy a build whose package
64
- doesn't match the app**, so you never publish to the wrong place. Add `--json` (in any
65
- position) to any command for machine-readable output.
64
+ doesn't match the app**, so you never publish to the wrong place. It also **refuses a version
65
+ code that isn't higher than the one currently live** (like the Play Store), so you can't ship a
66
+ downgrade. Add `--json` (in any position) to any command for machine-readable output.
66
67
 
67
68
  New apps are private; a nowrun admin decides which deployed apps are listed in ChatGPT.
68
69
  You stay signed in: the CLI refreshes its session automatically (for 30 days after last use).
@@ -5,7 +5,7 @@ long_description = (this_directory / "README.md").read_text(encoding="utf-8")
5
5
 
6
6
  setup(
7
7
  name='nowrun',
8
- version='v2.0.1',
8
+ version='v2.0.2',
9
9
  description='CLI to deploy and manage Android and HTML5 apps on nowrun.',
10
10
  long_description=long_description,
11
11
  long_description_content_type='text/markdown',
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes