Witan

Witan Docs

Witan gives coding agents and automation scripts a CLI, SDKs, and API for working with Excel workbooks, PowerPoint decks, and source documents.

Quickstart

Create a .xlsx workbook in a single command:

npx witan xlsx exec quickstart.xlsx --create --save --stdin <<'WITAN'
await xlsx.addSheet(wb, "Summary")
await xlsx.setCells(wb, [{ address: "Summary!A1", value: "Hello from Witan" }])
return await xlsx.readCell(wb, "Summary!A1")
WITAN

For the full walkthrough, see the Spreadsheets Quickstart.

Render a PowerPoint slide:

npx witan pptx render deck.pptx --slide 1 -o slide-1.png

What Witan Does

  • Script .xls, .xlsx, and .xlsm workbooks with witan xlsx exec.
  • Use JavaScript and Python SDKs for repeated workbook operations.
  • Verify workbook output with range rendering, formula recalculation, semantic linting, and pixel diffs.
  • Script .pptx presentations with Office.js-compatible JavaScript and render slides for visual checks.
  • Extract text and outlines from source documents with witan read.
  • Install Witan skill files so coding agents have workbook workflows and command details in context.

Start here

Task Page
Install and get started Quickstart
Understand how spreadsheets are handled Spreadsheets Overview
Understand how presentations are handled Presentations Overview
Run scripts from the CLI CLI Scripting
Run Office.js against PowerPoint decks Presentations CLI Scripting
Use Witan from 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

Tools

Tool What it does
Spreadsheets Read, write, recalculate, lint, and render Excel workbooks. New workbook creation uses .xlsx.
Presentations Create, inspect, edit, and render PowerPoint .pptx decks with Office.js-compatible scripts.
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

Next
Quickstart