Open Source · MIT Licensed

Give your AI agent Excel superpowers.

A CLI that reads, writes, and calculates Excel files. Structured JSON output. Built for agents, pipelines, and automation.

View on GitHub Learn More
Terminal 
$ wb read report.xlsx --range A1:D5 --format json

{
  "ok": true,
  "data": {
    "sheet": "Summary",
    "rows": [
      { "A1": "Revenue", "B1": 583200 },
      { "A2": "Margin",  "B2": 69984  }
    ]
  }
}

$ wb edit report.xlsx --patch '[{"cell":"B2","value":150000}]'

{ "ok": true, "cells_modified": 1 }

Built for machines, not just humans

Every command returns structured JSON. Every error includes a code and a hint. Your agent never has to guess.

Structured JSON output

Every response wraps in a consistent envelope with ok, data, and error fields. No parsing surprises.

Read, write, and calculate

Seven commands cover the full lifecycle: inspect, read cells, create workbooks, edit in place, recalculate formulas, and more.

Recoverable errors

Errors return a code, a message, and a hint for recovery. Your agent can catch SHEET_NOT_FOUND and try the next sheet automatically.

Your agent's Excel toolkit

Seven commands, one binary. Agents can inspect a file, read specific ranges, edit cells, and recalculate formulas — all through structured JSON.

Agent asks
$ wb info budget.xlsx
// What sheets exist? How big are they?
$ wb read budget.xlsx --range B2:D10
// Pull the numbers I need
Agent acts
$ wb edit budget.xlsx \
--patch '[{"cell":"B2","value":150000}]'
$ wb calc budget.xlsx --range D15
// Recalculate and verify the result

Predictable JSON envelope

Every response follows the same shape. Success or failure, your agent always knows where to look.

{
"ok": true,
"command": "read",
"data": { ... },
"error": null
}

JSON, Markdown, or CSV

Pick the format that fits your pipeline. JSON for agents, Markdown for humans, CSV for data tools.

--format json Structured, machine-readable
--format md Markdown tables for chat
--format csv Pipe to other tools

Built-in formula engine

55 functions across math, statistics, text, date, logic, and lookup. No Excel installation required.

SUM VLOOKUP IF INDEX AVERAGE COUNTIF CONCATENATE +48 more

Single binary, zero dependencies

One binary, no runtime, no LibreOffice, no Python. Drop it in a Docker image or a CI step and it just works.

macOS / Linux / Windows Single binary
External dependencies
0

Up and running in seconds

No configuration. No runtime. Just install and start reading spreadsheets.

1

Install

go install github.com/jpoz/werkbook/cmd/wb@latest
2

Read

$ wb read data.xlsx
3

Calculate

$ wb calc data.xlsx

Give your agent a spreadsheet brain

One binary. Structured JSON. 55 formula functions. Your AI agent can read, write, and calculate Excel files in seconds.

View on GitHub Read the Docs