Metadata-Version: 2.4
Name: maybeai-sheet-cli
Version: 0.1.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 so humans, CI jobs, and agents can perform common workbook operations without dynamically generating curl or Python glue.

## Install

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

## Requirements

- Python 3.10+
- `MAYBEAI_API_TOKEN`

## Quick Start

Set your token:

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

List worksheets in a workbook:

```bash
maybeai-sheet sheet worksheets --doc-id 6a3b3ec9b225d9fe7982ff36
```

Read a worksheet:

```bash
maybeai-sheet sheet read --doc-id 6a3b3ec9b225d9fe7982ff36 --worksheet-name "利润分析"
```

Read headers from a specific worksheet gid:

```bash
maybeai-sheet sheet headers --doc-id 6a3b3ec9b225d9fe7982ff36 --gid 3
```

Create a workbook:

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

Append rows and read back:

```bash
maybeai-sheet sheet append \
  --doc-id 6a3b3ec9b225d9fe7982ff36 \
  --gid 3 \
  --rows rows.json \
  --verify
```

## Command Groups

- `workbook`
  - `create`
  - `create-from-file`
- `sheet`
  - `read`
  - `read-range`
  - `headers`
  - `worksheets`
  - `formulas`
  - `write-range`
  - `append`
  - `upsert`
  - `create-worksheet`
- `raw`
  - `post`

## Output

The CLI defaults to JSON output and returns a stable envelope containing:

- `success`
- `endpoint`
- `target`
- `result`
- optional `verify`

Alternative output modes:

```bash
maybeai-sheet sheet worksheets --doc-id <DOC_ID> --output table
maybeai-sheet sheet worksheets --doc-id <DOC_ID> --output yaml
```

## Development

Create a virtual environment and install editable dependencies:

```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
```

Build distributions:

```bash
pip install build twine
python -m build
twine check dist/*
```

## Repository Split

This repository owns the software artifact:

- `src/`
- `tests/`
- `pyproject.toml`
- packaging and release concerns

Skill assets were intentionally split out into the sibling repository directory:

- `../maybeai-sheet-cli-skill`

That skill repo owns:

- `SKILL.md`
- `agents/`
- `references/`
- `scripts/`
- agent-facing workflow documentation
