maybeai-sheet-cli 0.1.0

CLI for common MaybeAI spreadsheet operations

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

pip install maybeai-sheet-cli

Requirements

• Python 3.10+
• MAYBEAI_API_TOKEN

Quick Start

Set your token:

export MAYBEAI_API_TOKEN="YOUR_TOKEN"

List worksheets in a workbook:

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

Read a worksheet:

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

Read headers from a specific worksheet gid:

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

Create a workbook:

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

Append rows and read back:

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:

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:

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

Run tests:

python -m unittest discover -s tests -v

Build distributions:

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