Metadata-Version: 2.1
Name: actionbox
Version: 0.1.6
Summary: input() for software that cannot wait at the terminal
Home-page: https://actionbox.cloud
License: MIT
Project-URL: Documentation, https://actionbox.cloud/docs
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.9
Description-Content-Type: text/markdown

<img src="https://actionbox.cloud/appbox.svg" width="64" alt="Actionbox logo">

# Actionbox CLI

Actionbox is `input()` for software that cannot wait at the terminal. The CLI
lets scripts, CI jobs, scheduled tasks, and AI agents ask a human for a decision
and continue when the answer arrives.

## Install

Install the platform-specific CLI wrapper from PyPI:

```bash
pip install actionbox
```

Or use the standalone installer on macOS and Linux:

```bash
curl -fsSL https://actionbox.cloud/install.sh | sh
```

## Get started

Create a Source in the Actionbox dashboard, then configure the CLI with its API
key:

```bash
actionbox configure
actionbox doctor
actionbox ask "Deploy to production?" --option approve --option reject --wait
```

The waiting command exits after the Action is resolved. Stopping it with
`Ctrl+C` only stops local polling; the Action remains open in Actionbox.

## Scheduled-job monitoring

Create and manage heartbeat Watches from the CLI, or wrap an existing command
so Actionbox receives start, success, and failure signals:

```bash
actionbox watch list
actionbox run --watch-url "$ACTIONBOX_WATCH_URL" -- ./backup.sh
```

Keep Source API keys and Watch URLs in a secret manager or protected CI
environment. Do not embed them in browser code, logs, or source control.

## Documentation

- [Actionbox documentation](https://actionbox.cloud/docs)
- [Actionbox website](https://actionbox.cloud)

## License

MIT.


