Metadata-Version: 2.1
Name: nook-cli
Version: 0.1.0
Summary: Python CLI for the Nook Android instrumentation server
Home-page: https://github.com/x1aon1ng/Nook
Author: Nook Contributors
Author-email: 3049155267@qq.com
License: MIT
Platform: UNKNOWN
Description-Content-Type: text/markdown

# Nook Python Host Package

`host/nook-py` provides the Python host SDK and CLI for Nook.

It exposes:

- `nook-cli`

## Install

Install from PyPI:

```powershell
pip install nook-cli
```

Verify:

```powershell
nook-cli --help
```

## Prerequisite

`nook-cli` expects a running `nook-server` on the Android device.

The Python package does not build or launch the Android server automatically. Download `nook-server` from the matching GitHub Release, then push and start it manually:

```powershell
adb push .\nook-server /data/local/tmp/nook/nook-server
adb shell "su -c 'chmod 755 /data/local/tmp/nook/nook-server'"
adb shell "su -c '/data/local/tmp/nook/nook-server'"
```

## Common Usage

Attach:

```powershell
nook-cli -U com.demo.target -l .\hook.js
```

Spawn:

```powershell
nook-cli -U -f com.demo.target -l .\hook.js
```

List processes:

```powershell
nook-cli -U ps
```

List applications:

```powershell
nook-cli -U apps
```

## Notes

- Rooted Android device required
- Current primary target is `arm64-v8a`
- `--strict-zygote-control` remains experimental


