maybeai-sheet-cli 0.3.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 for humans, CI jobs, and agents.

Install

On Debian/Ubuntu and other PEP 668 systems, do not use bare pip install on system Python. Use pipx (recommended for CLIs):

sudo apt install -y pipx python3-venv
pipx ensurepath
# re-login or: source ~/.bashrc

pipx install maybeai-sheet-cli
maybeai-sheet --version

For local venvs or macOS/dev machines, plain pip is fine:

pip install maybeai-sheet-cli

Upgrade to the latest release:

maybeai-sheet update          # when installed via pip or pipx
pipx upgrade maybeai-sheet-cli   # alternative on pipx installs

Install a specific version:

maybeai-sheet update --version 0.3.0
pipx install maybeai-sheet-cli==0.3.0 --force   # pipx reinstall pin

Uninstall:

pipx uninstall maybeai-sheet-cli
# not: pip uninstall -U  (-U is invalid for uninstall)

Requirements

• Python 3.10+
• MAYBEAI_API_TOKEN

Configure

Set your API token:

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:

maybeai-sheet sheet read --doc-id abc123

List worksheets:

maybeai-sheet sheet worksheets --doc-id abc123

Read headers from a worksheet:

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

Create a workbook:

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

Upload a workbook-style .xlsx through the default Excelize path:

maybeai-sheet workbook create-from-file ./report.xlsx

Import a large table-like .xlsx into SheetTable/PG:

maybeai-sheet workbook create-from-file ./large-table.xlsx --engine postgres

Append rows and verify:

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

Make a workbook public for viewers:

maybeai-sheet share visibility --doc-id abc123 --visibility public --public-permission viewer

Commands

• update
• workbook create
• workbook create-from-file
• workbook manifest
• workbook capabilities
• share visibility
• share grant
• share permission
• share remove
• share list
• 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

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

Run tests:

python -m unittest discover -s tests -v