Metadata-Version: 2.4
Name: stay-available
Version: 0.4.0
Summary: Keep your system active with smooth infinity cursor movement — a lightweight CLI that prevents idle/away status by tracing a continuous ∞ path with your cursor.
Author: Manvith Gopu
License: MIT
Project-URL: Homepage, https://github.com/DayInfinity/stayAvailable
Project-URL: Repository, https://github.com/DayInfinity/stayAvailable
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyautogui
Requires-Dist: typer
Requires-Dist: rich
Dynamic: license-file

# stayAvailable ∞

> Keep your system active with smooth infinity cursor movement.

`stay-available` is a lightweight Python CLI tool that prevents your system from going idle or showing as "Away" — by silently moving your cursor in a continuous ∞ (infinity/lemniscate) path in the background.

No clicking, no typing simulation, no jittery random movement — just a clean, smooth parametric curve your system notices but you barely will.

---

## Features

- ∞ **Infinity-path cursor movement** — smooth, parametric, non-intrusive
- 🖥️ **Zero UI** — runs entirely from the terminal
- ⚡ **Instant start** — one command and you're active
- 🎨 **Rich terminal output** — clean status display via `rich`
- 🪶 **Lightweight** — no background daemons, no config files

---

## Installation

```bash
pip install stay-available
```

**Requirements:** Python 3.8+

---

## Usage

```bash
stay-available
```

That's it. The cursor starts tracing an infinity loop. Press `Ctrl+C` to stop.

### Options

```
stay-available --help
```

---

## How it works

The cursor follows a **lemniscate of Bernoulli** — a figure-eight curve parameterized as:

```
x(t) = A · cos(t) / (1 + sin²(t))
y(t) = A · sin(t)·cos(t) / (1 + sin²(t))
```

`pyautogui` moves the cursor along sampled points of this curve in a loop, keeping the OS activity timer alive without triggering any visible interaction.

---

## Dependencies

| Package | Role |
|---|---|
| `pyautogui` | Cursor movement |
| `typer` | CLI framework |
| `rich` | Terminal output formatting |

---

## License

[MIT](LICENSE) © 2026 Manvith Gopu
