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.
- {nowrun-2.0.1 → nowrun-2.0.2}/PKG-INFO +13 -12
- {nowrun-2.0.1 → nowrun-2.0.2}/README.md +12 -11
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/cli.py +11 -10
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/inspect.py +1 -2
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/config.py +23 -19
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/skill/SKILL.md +20 -24
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/PKG-INFO +13 -12
- {nowrun-2.0.1 → nowrun-2.0.2}/setup.py +1 -1
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/__init__.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/__main__.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/apk.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/appmeta.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/client.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/__init__.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/admin.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/app.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/deploy.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/legacy.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/login.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/mcp.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/mode.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/setup.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/skill.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/update.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/commands/validate.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/fields.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/output.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/passthrough.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun/upload.py +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/SOURCES.txt +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/dependency_links.txt +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/entry_points.txt +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/requires.txt +0 -0
- {nowrun-2.0.1 → nowrun-2.0.2}/nowrun.egg-info/top_level.txt +0 -0
- {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.
|
|
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
|
-
|
|
17
|
+
Publish Android apps so people can run them inside ChatGPT - driven by your AI coding agent.
|
|
18
18
|
|
|
19
|
-
`nowrun` publishes Android
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
(native, Unity, Godot, Unreal)
|
|
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
|
|
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
|
|
44
|
-
|
|
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
|
|
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.
|
|
65
|
-
|
|
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
|
-
|
|
3
|
+
Publish Android apps so people can run them inside ChatGPT - driven by your AI coding agent.
|
|
4
4
|
|
|
5
|
-
`nowrun` publishes Android
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
(native, Unity, Godot, Unreal)
|
|
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
|
|
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
|
|
30
|
-
|
|
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
|
|
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.
|
|
51
|
-
|
|
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
|
|
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
|
|
116
|
-
"Every command supports --json for
|
|
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
|
|
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
|
|
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
|
|
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)
|
|
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
|
|
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
|
|
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.
|
|
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
|
|
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
|
-
#
|
|
41
|
-
#
|
|
42
|
-
|
|
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.
|
|
90
|
-
(
|
|
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
|
-
|
|
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
|
|
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
|
|
9
|
-
|
|
10
|
-
(browser); you operate the CLI, and the
|
|
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
|
|
89
|
-
|
|
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
|
-
|
|
110
|
-
|
|
111
|
-
|
|
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
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
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.
|
|
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`
|
|
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.
|
|
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
|
-
|
|
17
|
+
Publish Android apps so people can run them inside ChatGPT - driven by your AI coding agent.
|
|
18
18
|
|
|
19
|
-
`nowrun` publishes Android
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
(native, Unity, Godot, Unreal)
|
|
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
|
|
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
|
|
44
|
-
|
|
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
|
|
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.
|
|
65
|
-
|
|
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.
|
|
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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|