Metadata-Version: 2.1
Name: nowrun
Version: 1.5.0
Summary: CLI to deploy and manage Android and HTML5 apps on nowrun.
Home-page: https://nowrun.io
Author: nowrun
Author-email: cloudmaster@now.gg
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# nowrun CLI

Deploy Android and HTML5 apps to a live URL, straight from your AI coding agent.

`nowrun` publishes Android and HTML5 apps to [nowrun](https://nowrun.io) and streams each
one at a URL anyone can open in a browser - no install. Android works with any engine that
builds an APK (native, Unity, Godot, Unreal); HTML5 web games deploy as a zipped bundle.

## Install

```
pip install nowrun
```

Already installed? `nowrun update` upgrades the CLI and refreshes the skill + MCP server.

## Setup

You need Python 3.8+ and a nowrun account - the human creates one and verifies a card at
[nowrun.io](https://nowrun.io). One command signs the CLI in through your browser **and**
sets up your agent, with no token to copy or paste:

```
nowrun login       # opens the browser to sign in, then installs the skill & MCP server
```

Sign out anytime with `nowrun logout` (it revokes this device's session). Then open your AI
tool in the project folder and ask it to deploy your app. It learns the CLI from
`nowrun help --json` and `nowrun <command> -h`.

## Everyday commands

| Command | Does |
|---------|------|
| `nowrun app create --title "My App" -p com.foo.bar --category Tools` | create an app and bind this folder to it (or `--from-apk app.apk` to read the package name from the build) |
| `nowrun app list` | list your apps |
| `nowrun use <game_id>` | set a default app so you can drop `-a` |
| `nowrun inspect app.apk` | read a build's package name, version name and version code (no Android SDK needed) |
| `nowrun app set-icon --from-apk app.apk` | set the app icon from the build's launcher icon (or pass an image path) |
| `nowrun validate` | show what's missing before deploying |
| `nowrun deploy -f app.apk` | deploy a build and get its live link (version read from the APK; `--wait` blocks until live) |
| `nowrun status -s <submission_id>` | poll until it's live |
| `nowrun help` | full command list + workflow |

`deploy` reads the build's package/version for you, and **refuses to deploy a build whose
package doesn't match the app** (so you never publish to the wrong app).

Tips: credentials are stored globally, so the CLI works from any folder; identify an app by
its `game_id` (from `app create` / `app list`); add `--json` to any command for
machine-readable output (it works in any position).

## Other AI tools

`nowrun login` (and `nowrun setup`) set up Claude by default. For another tool, run
`nowrun setup --target <tool>` - it installs whichever pieces that tool supports:

| Target | Skill file | MCP config |
|--------|-----------|------------|
| `claude` | `~/.claude/skills/nowrun/SKILL.md` | `~/.claude.json` |
| `codex` | `AGENTS.md` | `~/.codex/config.toml` |
| `copilot` | `.github/copilot-instructions.md` | - |
| `cursor` | - | `.cursor/mcp.json` |
| `vscode` | - | `.vscode/mcp.json` |

```
nowrun setup --target cursor
```

For anything else: `nowrun skill show` and `nowrun mcp show` print content you can paste.

## Links

- nowrun: https://nowrun.io
- Docs: https://nowrun.io/docs


