Metadata-Version: 2.1
Name: nowrun
Version: 2.1.1
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

Publish Android apps so people can run them inside ChatGPT - driven by your AI coding agent.

`nowrun` publishes Android apps to [nowrun](https://nowrun.io) so people can run them inside
ChatGPT (and other AI assistants that connect to nowrun) - streamed into the conversation, no
install and no app store. You don't run deploy commands by hand: you set the CLI up once, then
tell your agent to ship. Works with any engine that builds an APK (native, Unity, Godot, Unreal).

## Quickstart

**1. Create your account.** Sign up and verify a payment card at [nowrun.io](https://nowrun.io)
(a $0 check, no charge on the free plan). This is the one step only a human can do.

**2. Connect the CLI (one time).** Requires Python 3.8+.

```
pip install nowrun
nowrun login          # opens the browser to sign in; also installs the AI skill + docs MCP
```

`nowrun login` authorizes this machine and teaches your agent how to use nowrun - no token to
copy or paste. (`nowrun update` refreshes it later; `nowrun logout` signs out.)

**3. Tell your agent.** Open your AI coding tool in your project and give it this prompt:

> 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

Your agent creates (or reuses) the app, uploads the build, and deploys it - and once it's live,
people can run it inside ChatGPT. That's the whole flow.

## What your agent runs for you

You normally never touch these - your agent does, guided by the skill `nowrun login` installed.
They're here for reference (and the occasional manual run):

| Command | Does |
|---------|------|
| `nowrun app categories` | the categories an app can have |
| `nowrun app create --title "My App" -p com.foo.bar --category Tools --short-description ... --long-description ... --intent ... --kind app --orientation portrait --icon icon.png` | create an app with its full listing - every field is required (or `--from-apk app.apk` to read the package and icon from the build; `--data app.json` to pass the fields as JSON) |
| `nowrun app update --short-description ... --icon icon.png` | change any of an app's metadata |
| `nowrun app list` / `nowrun app show` | list your apps / show one, with its visibility, readiness, Publish to ChatGPT status and MCP URL |
| `nowrun inspect app.apk` | read a build's package + version, no Android SDK needed |
| `nowrun validate` | check what's missing before deploying |
| `nowrun deploy -f app.apk` | deploy a build so it's runnable in ChatGPT (version read from the APK; `--wait` blocks until live) |
| `nowrun status -s <submission_id>` | poll until it's live |
| `nowrun help --json` | full command list + workflow (what the agent reads) |

`deploy` reads the build's package/version and **refuses to deploy a build whose package
doesn't match the app**, so you never publish to the wrong place. It also **refuses a version
code that isn't higher than the one currently live** (like the Play Store), so you can't ship a
downgrade. Add `--json` (in any position) to any command for machine-readable output.

New apps are private; a nowrun admin decides who can use each app and whether nowrun's public
plugin shows it.
You stay signed in: the CLI refreshes its session automatically (for 30 days after last use).

## 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


