maybeai-sheet-cli 0.2.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

pip install maybeai-sheet-cli

Upgrade to the latest release:

maybeai-sheet update

Install a specific version:

maybeai-sheet update --version 0.2.0

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"

Append rows and verify:

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

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

Run tests:

python -m unittest discover -s tests -v