Witan Docs
Witan provides a CLI, SDKs, and API for working with Excel workbooks and source documents from automated coding workflows.
The current product is Witan Spreadsheet. It works with ordinary Excel workbook files, centered on the widely used Office Open XML .xlsx format, and is designed for bidirectional compatibility with Microsoft Excel: workbooks created or edited by Witan can be opened and edited in Excel, and workbooks created or edited in Excel can be opened and edited by Witan, within the documented supported feature set.
Witan Spreadsheet combines three parts:
- Workbook scripting through
witan xlsx exec, where JavaScript runs against a live workbook handle. - SDK sessions for JavaScript and Python applications that need repeated workbook operations.
- Verifier commands for recalculation, semantic linting, range rendering, and pixel diffs.
That combination lets coding agents edit a real workbook, inspect what they read and wrote, recalculate affected formulas, lint for spreadsheet-specific mistakes, render the visible result, and save only when the result is acceptable.
Start here
| Task | Page |
|---|---|
| Install Witan and run the first workbook commands | Quickstart |
| Understand how workbook execution works | Spreadsheet Overview |
| Run scripts from the CLI | CLI Scripting |
| Use Witan from Node.js or TypeScript | JavaScript SDK |
| Use Witan from Python | Python SDK |
| Check visual output, formulas, and semantic issues | Render, Calc, Lint |
| Install agent skill files | Agent Skills |
| Deploy the API in your own infrastructure | Self-Hosting |
| Reference every CLI command | CLI Reference |
Current tools
| Tool | What it does |
|---|---|
| Spreadsheet | Read, write, recalculate, lint, and render .xls, .xlsx, and .xlsm workbooks. New workbook creation uses .xlsx. |
witan read |
Extract text or outlines from PDFs, Word documents, PowerPoint decks, HTML, text, Markdown, CSV, JSON, XML, YAML, and TOML. |
Execution model
By default, the CLI and SDKs call Witan Cloud. Anonymous personal use is stateless: each request sends the file for that operation and does not reuse a server-side file cache. Authenticated organization-backed requests use files-backed mode by default, which uploads workbook revisions and reuses them across repeated operations. The same API can also be deployed through Self-Hosting.
See CLI Reference for authentication, stateless mode, and file-retention behavior.
Get in touch
- Email - hello@witanlabs.com
- GitHub - witanlabs
- Research log - witanlabs/research-log