Playbooks · Coding
Recalc: agents inside spreadsheet cells
Written November 10, 2026
Recalc is a spreadsheet where every cell can hold a value, a formula, a terminal command, or a coding agent. The idea is to check an agent's work in the sheet itself, instead of in a separate chat window.
The problem
A coding agent that says it is done leaves you with one question: is it actually done? The usual answer is to open a terminal, run the tests yourself, and compare. Recalc puts the check next to the claim. A cell holding the agent's answer sits beside a cell that runs the tests, and the test cell turns red when something is wrong. You can even stop a Claude Code session from finishing until its row goes green.
What a cell can hold
From the Recalc repository, the first character of a cell decides what it is:
| You type | It is | What happens |
|---|---|---|
42 | A value | It just sits there |
= {passed} > 0 | A formula | Updates when the cells it reads change |
$ npm test | A command | Runs in your terminal, and its output becomes the value; re-runs when its inputs change |
! git push | An action | Only runs when you run it, for anything that changes things |
@claude('summarize {A2}') | An agent | Asks Claude (or @codex, or @pi) and puts the answer in the cell; only runs when you run it |
{A2} pulls another cell's value into a formula, a command, or an agent prompt. The agents running in Recalc understand how it works through an MCP server, and an agent you run yourself in a terminal can connect the same way with claude mcp add recalc -- recalc mcp.
What it is for
Three uses the project demonstrates:
- Checking an agent's "done". Put a cell that runs your tests next to the cell where the agent says it finished. The test cell re-runs by itself whenever the code changes.
- Asking many documents the same questions. Put files down one side and questions across the top, then run the board. An agent answers every cell, and each answer links to the exact passage it came from. Answers you have reviewed are marked, and agents cannot overwrite them after that.
- Running several agents at once. Give each agent its own row and watch them all on one screen. Anything that needs you — a question, an error, a finished answer — lands in one list called Needs You. A Driver agent can set the board up from a prompt.
Boards are folders of files on your computer. There is no account, no server, and no tracking; the only request Recalc makes on its own is a once-a-day check for a new version, which you can turn off. The agents you connect send what they always send to their own providers. It is free, under the Apache-2.0 licence, and works with Claude Code, Codex, and pi (experimental).
Getting started
On a Mac, the install line is curl -fsSL https://raw.githubusercontent.com/sshah03/recalc/main/install.sh | sh. The project says to read the script first if you like; it puts Recalc in Applications and a recalc command on your PATH. On Linux the same line installs an AppImage, but Linux support is experimental. The beta is not signed by Apple yet, so macOS refuses to open a downloaded copy until you clear its quarantine flag once with xattr -dr com.apple.quarantine /Applications/recalc.app. You also need an agent installed — Claude Code, Codex, or pi — and signed in once.
Limits
- Recalc describes itself as an early beta, in its own words very early in development, and warns to expect bugs, rough edges, and changes between versions that break things. Keep copies of anything you cannot afford to lose.
- Linux support is experimental, and there is no Windows version yet.
- Commands run with your permissions. Nothing that changes anything runs on its own — actions and agent cells only run when you say so, and an agent cannot be the first to run an action it wrote — but Recalc is not a sandbox, so run it where you would run those commands anyway.
- There is no independent test of Recalc to point to. The demos and examples on the project page are the project's own, and this page repeats what the project claims, not what anyone else has confirmed.
- The agents themselves are not free: Recalc costs nothing, but the agents you run use your own Claude or ChatGPT plan, the same as they do in a standalone terminal.
Related playbooks
- JetBrains Air is GA: agents inside your IDE
- Zalando's broker hands agents OAuth safely
- Antigravity's remote agents run in Google's cloud
- Baseten Sandboxes keep agents running for days
Sources
Back to: Coding playbooks hub · Also: iPhone-use: a phone agent, no Mac needed