recalc CLI
A spreadsheet where a cell holds a value, a formula, a command or an agent, filled in by Claude Code and Codex
- 73 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- `$` cells run commands in your terminal with your permissions and agent cells call Claude Code, Codex or pi
- The app is not a sandbox, so commands and `!` actions can change files and the repository, although they run only on your decision
Install
- Works in
Manual install
curl -fsSL https://raw.githubusercontent.com/sshah03/recalc/main/install.sh | shThe script installs the app in Applications and a `recalc` command; read it before running. macOS, Linux experimentally.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- `$` cells run commands in your terminal with your permissions and agent cells call Claude Code, Codex or pi
- The app is not a sandbox, so commands and `!` actions can change files and the repository, although they run only on your decision
This is third-party code. Review the repository files before installing.
What it does
recalc is a desktop spreadsheet in Rust that gives you and your agents one shared grid. A cell can hold a number, a formula, a terminal command or an AI agent. Agents write plans and results into cells while you watch, and commands in other cells check their work and turn red when something is wrong. To change something you edit a cell instead of interrupting the chat. The first character sets the type: `42` is a value, `= {passed} > 0` a formula, `$ npm test` a command that runs in your terminal and re-runs when its inputs change, `! git push` an action that runs only when you run it and `@claude('summarize {A2}')` an agent that answers on request (`@codex` and `@pi` also exist). `{A2}` pulls in another cell's value. Claude Code connects to a board with `claude mcp add recalc -- recalc mcp`, after which the agent knows the board is there and works with it. Examples: checking an agent's "done" with a test cell, a hundred documents with the same questions and answers that cite their quote, and several agents in one sheet with a "Needs You" list. A board is a folder of files with no account and no server. On macOS install with `curl -fsSL https://raw.githubusercontent.com/sshah03/recalc/main/install.sh | sh`.
Who it is for. People who run several agents at once and want to see their work, checks and questions on one sheet, for example in legal due diligence or financial reconciliation.
Good fit when
- An agent says "done" while a neighbouring `$ npm test` cell must show that tests are actually failing
- A hundred documents have to go through the same questions with a quote shown under each answer
- Several agents get a row each and all questions and errors gather in the "Needs You" list
- The board has to live in the repository in a `.recalc` folder so it can be committed
Not a fit when
- You need a cloud service with shared access: the board lives on your machine and there is no account
- The machine has none of Claude Code, Codex or pi: recalc runs the agents you already have
- You need a sandbox for commands: recalc is not a sandbox and commands run with your permissions
Example request
Fill the answer column in recalc for twelve contracts across six questions and show a quote in each cellLimitations
- The project is in early beta: the author warns of bugs and changes between versions that can break boards, so keep copies of anything you cannot lose.
- The app is not signed by Apple, so after a manual install you clear quarantine with `xattr -dr com.apple.quarantine /Applications/recalc.app` or click "Open Anyway". Linux is experimental and installs an AppImage.
- recalc is not a sandbox: commands and agents run with your permissions. `!` actions and agent cells run only when you say so, and an agent cannot be the first to run an action it wrote.
- Running agents spends your Claude or ChatGPT plan, and the dollar figures in the interface show the cost at API prices.
How to disable. Disconnect the agent with `claude mcp remove recalc` and delete the app from Applications; boards remain ordinary folders of files.
FAQ
How do I install recalc?
On macOS run `curl -fsSL https://raw.githubusercontent.com/sshah03/recalc/main/install.sh | sh`: it puts the app in Applications and a `recalc` command on your PATH. The script is short, so read it before running. On Linux the same line installs an AppImage, experimentally.
How do I connect Claude Code?
In the project folder run `claude mcp add recalc -- recalc mcp`. The agent then knows about the board and works with it itself; Codex and pi are covered in the app Agent menu.
How do I tell a formula, a command and an agent apart?
By the first character: `=` formula, `$` command, `!` action, `@claude(...)` agent. A number or text without a marker stays a value.
Does recalc cost anything?
No, the app is free and open source. Agents run on your own Claude or ChatGPT plan and the dollar figures in the app show the cost at API prices.
Where are boards stored?
New boards go in `~/Documents/recalc boards` and a project board lives in a `.recalc` folder you can commit or ignore.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI that gathers Claude Code and Codex session history into a local graph, searches it and turns repeated mistakes into fixes
Set up Claude Code and Codex in one conversation: global instructions, rules, plugins, skills, a status line and correction memory
Shared team memory about code: agreements and failed approaches live in git and the agent checks commands against them
Skill that reads your prompt history, finds the asks you repeat and turns each into a short command such as /sent
Plugins and CLI for a cloud task board: an idea becomes a card with a preview, and your agent delivers it once you approve.
A CLI that hands session context between coding agents: continue a Claude Code session in Codex, Cursor, OpenCode and others.
README in short
The README explains the idea of a spreadsheet for agents, shows four scenarios and demos, the install, cell types by first character, Claude Code connection through MCP, and answers on cost, safety and board storage.