Metadata-Version: 2.1
Name: nowrun
Version: 1.0.0
Summary: CLI to deploy and manage Android 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 apps to a live URL, straight from your AI coding agent.

`nowrun` publishes Android apps to [nowrun](https://nowrun.io) and streams each one at a
URL anyone can open in a browser — no install. Any engine that builds an APK works
(native, Unity, Godot, Unreal).

## 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 **token** — the human creates an account and verifies a card at
[nowrun.io](https://nowrun.io), then copies the token. One command authenticates the CLI
**and** sets up your agent:

```
nowrun init -t <token>      # authenticates + installs the nowrun skill & MCP server
```

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 --publisher "Foo" --category Tools --bind` | create an app and bind this folder to it |
| `nowrun app list` | list your apps |
| `nowrun use <game_id>` | set a default app so you can drop `-a` |
| `nowrun validate` | show what's missing before deploying |
| `nowrun deploy -f app.apk -av 1.0 -vc 1` | deploy a build and get its live link |
| `nowrun status -s <submission_id>` | poll until it's live |
| `nowrun help` | full command list + workflow |

Tips: `nowrun init` stores credentials in `~/.nowrun` (works from any folder); add `--json`
to any command for machine-readable output.

## Other AI tools

`nowrun init` (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` | `.mcp.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://github.com/nowrun-io/nowrun-docs


