Metadata-Version: 2.4
Name: rehuco-agent
Version: 0.1.1
Summary: rehuco PySide6 desktop GUI
Project-URL: Homepage, https://borco.github.io/rehuco/
Project-URL: Repository, https://github.com/borco/rehuco/tree/master/packages/rehuco-agent
Project-URL: Issues, https://github.com/borco/rehuco/issues
Author-email: Ioan Calin <iborco@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: desktop,gui,pyside6,qt,rehu,rehuco,resource-management
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Desktop Environment
Requires-Python: >=3.14
Requires-Dist: borco-core
Requires-Dist: borco-pyside
Requires-Dist: cbor2>=6.1.3
Requires-Dist: humanize>=4.16.0
Requires-Dist: markdown>=3.7
Requires-Dist: mistletoe>=1.4.0
Requires-Dist: pathvalidate>=3.3.1
Requires-Dist: pillow
Requires-Dist: pyside6-essentials>=6.9
Requires-Dist: pyside6-qtads>=5.0.0
Requires-Dist: pyside6-scintilla>=5.6.3.7
Requires-Dist: python-dateutil>=2.9.0
Requires-Dist: rehuco-core
Requires-Dist: unidecode>=1.4.0
Description-Content-Type: text/markdown

# rehuco-agent

[![PyPI](https://img.shields.io/pypi/v/rehuco-agent)](https://pypi.org/project/rehuco-agent/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/borco/rehuco/blob/master/LICENSE)
[![Python versions](https://img.shields.io/pypi/pyversions/rehuco-agent)](https://pypi.org/project/rehuco-agent/)

*PySide6 desktop GUI for [rehuco](https://borco.github.io/rehuco/): open, view, and edit `.rehu` files.*

[View on PyPI](https://pypi.org/project/rehuco-agent/) · [View on GitHub](https://github.com/borco/rehuco)

## Status

**Early.** The editor works: it opens a `.rehu`, shows and edits its fields, and saves.
The `.rehu` format is still moving and there is no upgrade guarantee between releases yet, so
keep backups of anything you point it at. See [GitHub Issues](https://github.com/borco/rehuco/issues)
for what's in progress.

## What it is

`rehuco-agent` is [rehuco](https://borco.github.io/rehuco/) itself, as far as anything you can run
goes: a desktop editor for the `.rehu` sidecar that describes one resource. Tested on Windows, macOS,
and Linux.

![The rehuco-agent editor: fields on the left, rendered viewer on the right](https://raw.githubusercontent.com/borco/rehuco/master/docs/assets/images/rehuco-agent.png)

- **Single-instance launcher** — double-click a `.rehu` file to open it in the running instance
- **Viewer and editor** — common fields, a Markdown description, and the resource's screenshots as a
  thumbnail strip with a click-to-maximize lightbox
- **Editing that saves atomically** — with unrecognized fields left untouched, and a file from a newer
  format version opened read-only rather than rewritten
- **Legacy `.tc` conversion** — read the predecessor format and write `.rehu`, keeping backups
- **A workspace that persists** — per-file panel layout and session restore

## Goals

`rehuco-agent` aims to be:

- **MIT licensed** — usable in open-source or closed-source projects freely
- **PySide6 native** — built on Qt via PySide6 and the pyqtads docking framework
- **Single-instance** — one running app per user; additional launches forward their arguments in

## Installation

```bash
pip install rehuco-agent
```

PySide6 6.9+ is installed automatically as a dependency.

## License

[MIT](https://github.com/borco/rehuco/blob/master/LICENSE)
