Metadata-Version: 2.4
Name: uvero
Version: 0.1.3
Summary: Uvero CLI – online clipboard from your terminal
Author-email: Uvero <support@uvero.app>
License-Expression: MIT
Project-URL: Homepage, https://uvero.app
Project-URL: Repository, https://github.com/sakethdevx/uvero-cli
Project-URL: Bug Tracker, https://github.com/sakethdevx/uvero-cli/issues
Keywords: clipboard,cli,terminal,online clipboard,paste,share
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Classifier: Topic :: Internet
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: requests>=2.28.0
Requires-Dist: pyperclip>=1.8.0
Requires-Dist: rich>=13.0.0
Dynamic: license-file

# uvero-cli

**Uvero** is an online clipboard service. This CLI lets you interact with it directly from your terminal.

## Installation

```bash
pip install uvero
```

## Quick start

Run the built-in help first if you want a command overview:

```bash
uvero --help
uvero send --help
uvero get --help
uvero open --help
uvero version
uvero board --help
```

## How the CLI works

- `uvero send` uploads content, gives you a share code, and copies the code to your clipboard.
- Public share links use `https://uvero.app/c/CODE`.
- `uvero get CODE` retrieves content using that code.
- A single `-` is special:
  - `uvero send -` reads from your system clipboard.
  - `uvero get CODE -` writes to your system clipboard.

## Usage

### Send content

```bash
# Interactive paste mode (CTRL+D to finish)
uvero send

# Send a file
uvero send notes.txt

# Send system clipboard contents
uvero send -

# Pipe data
cat log.txt | uvero send

# Print only the code (for scripting)
uvero send notes.txt --raw
```

### Retrieve content

```bash
# Save to uvero_4832.txt
uvero get 4832

# Save to a specific file
uvero get 4832 notes.txt

# Copy directly to system clipboard
uvero get 4832 -
```

If you omit the output path, Uvero saves the content to `uvero_CODE.txt`.

### Open a clipboard link in browser

```bash
uvero open 4832
```

### Show CLI version

```bash
uvero version
```

## Auto-updates

- On startup, Uvero checks PyPI (max once every 24 hours) and auto-upgrades when a newer version is available.
- The updated version is used from the next command run.
- To disable auto-upgrade, set `UVERO_AUTO_UPGRADE=0`.

### Boards (private shared clipboards)

```bash
# Create a board
uvero board create

# Send to a board
uvero board send abcd-def notes.txt
uvero board send abcd-def   # interactive paste mode

# Get board content
uvero board get abcd-def
```

For detailed command help at any time, run `uvero --help` or `uvero <command> --help`.
