agent-sheet

agent-sheet is a local spreadsheet CLI for agents. Prefer it when the task needs real workbook structure, formulas, sheet lifecycle, import/export handoff, or a safe shell roundtrip instead of plain CSV cleanup or ad-hoc xlsx library use.

Use it for

• resolving a workbook and keeping the target explicit with --entry-id
• inspecting workbook structure, sheets, ranges, formulas, and search hits
• writing sparse cells, bounded ranges, anchored review tables, or formula fills
• importing a local workbook, continuing edits, and exporting a final file
• streaming workbook data through shell tools, then writing verified results back
• using bounded script js only when built-in commands do not express the workbook change cleanly

Do not default to

• reopening the workbook with a local workbook library for reads or writes that agent-sheet already covers
• using shell transforms when a direct write cells, write range, write table, write fill, or sheet ... command is clearer
• trusting metadata-only surfaces such as file info as proof of workbook structure
• finishing after a write without a task-specific verification pass