Metadata-Version: 2.4
Name: maybeai-sheet-cli
Version: 0.2.0
Summary: CLI for common MaybeAI spreadsheet operations
Project-URL: Homepage, https://github.com/OmniMCP-AI/maybeai-sheet-cli
Project-URL: Repository, https://github.com/OmniMCP-AI/maybeai-sheet-cli
Project-URL: Issues, https://github.com/OmniMCP-AI/maybeai-sheet-cli/issues
Author: OmniMCP-AI
License: Proprietary
Keywords: cli,excel,maybeai,spreadsheet
Classifier: Environment :: Console
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.27
Requires-Dist: pydantic<3,>=2.7
Requires-Dist: pyyaml<7,>=6
Requires-Dist: rich<14,>=13.7
Requires-Dist: typer<1,>=0.12
Description-Content-Type: text/markdown

# maybeai-sheet-cli

CLI for MaybeAI spreadsheet operations.

`maybeai-sheet` wraps the MaybeAI spreadsheet HTTP APIs behind a stable command-line interface for humans, CI jobs, and agents.

## Install

```bash
pip install maybeai-sheet-cli
```

Upgrade to the latest release:

```bash
maybeai-sheet update
```

Install a specific version:

```bash
maybeai-sheet update --version 0.2.0
```

## Requirements

- Python 3.10+
- `MAYBEAI_API_TOKEN`

## Configure

Set your API token:

```bash
export MAYBEAI_API_TOKEN="YOUR_TOKEN"
```

Optional global flags:

- `--base-url` to point at a different MaybeAI API host
- `--output json|table|yaml`
- `--timeout <seconds>`
- `--verbose`

## Quick Start

Read a workbook:

```bash
maybeai-sheet sheet read --doc-id abc123
```

List worksheets:

```bash
maybeai-sheet sheet worksheets --doc-id abc123
```

Read headers from a worksheet:

```bash
maybeai-sheet sheet headers --doc-id abc123 --gid 3
```

Create a workbook:

```bash
maybeai-sheet workbook create --title "Board Pack"
```

Append rows and verify:

```bash
maybeai-sheet sheet append --doc-id abc123 --gid 3 --rows rows.json --verify
```

## Commands

- `update`
- `workbook create`
- `workbook create-from-file`
- `workbook manifest`
- `workbook capabilities`
- `sheet read`
- `sheet read-range`
- `sheet read-many`
- `sheet named-range`
- `sheet headers`
- `sheet worksheets`
- `sheet formulas`
- `sheet write-range`
- `sheet clear-range`
- `sheet append`
- `sheet formula-set`
- `sheet formula-batch-set`
- `sheet recalculate`
- `sheet upsert`
- `sheet create-worksheet`
- `raw post`

## Input Rules

- Use `--doc-id`, `--url`, or `--uri` to identify a workbook.
- Use `--worksheet-name` when the endpoint supports it.
- Use `--gid` for gid-specific sheet targeting.
- File inputs like `--rows`, `--values`, `--targets`, and `--operations` must be JSON.

## Output

Default output is JSON. `table` is optimized for sheet-like payloads; `yaml` is also supported.

## Development

```bash
python3 -m venv .venv
. .venv/bin/activate
pip install -U pip
pip install -e .
```

Run tests:

```bash
python -m unittest discover -s tests -v
```
