Calcwright

Getting started

Everything here is also in the app: Help → Tutorials walks you through a first calculation, a diagram drawn from your values and a test in versions, and Examples → Learn Calcwright explains one part of Calcwright an example.

Install

Nothing to install to start: open worksheet.calcwright.app and type. The web version has every worksheet feature, but no AI connection. The desktop app, which your AI connects to, is coming soon for macOS; Windows is planned. Once it is released, download it from the Download page and open it.

install steps not written There is no release yet, so the install steps are still to come.

Your first calculation

Click a page to put the red crosshair there, and type. Each thing you type is a region where you clicked, and you can drag it anywhere. The math is worked out top to bottom, then left to right, so define a name above where you use it.

TypeShowsMeans
x:3x ≔ 3Define a name
x*2=x·2 = 6Show a value
L:12ftL ≔ 12 ftUnits go with numbers
F.n:12NFn ≔ 12 NA dot types a subscript
"NotesNotesA text region
@sin(t)a plotThen Tab, and t for the x-axis
  • Enter leaves a math region with the crosshair under it; Esc leaves any region.
  • A blue editing line marks what the next operator applies to. Press Space to widen it: a+b, Space, /2 is (a + b)/2.
  • While you type a name, suggestions list the sheet's names, functions and units. Tab takes one.
  • The math palette at the left types every sign, Greek letter and operator. Hover over a button to see what it does.
  • g~9.81 defines a name for the whole sheet, g ≡ 9.81, seen even above it.
  • Press ? on the paper, or choose Help → Keyboard shortcuts, for every key.

Units

Every value carries its dimensions. A unit is written against its number, 12kN/m, 3ft, 30deg, and adding a length to a time is an error. Results are shown in the unit that suits their size, to four significant figures: 30 kN, 250 MPa, 67.5 kN·m, 15.1 mm, 2.5 mA. Areas, volumes and second moments of area are in mm², mm³ and mm⁴, as steel tables print them: 8.438·10⁶ mm³, 245·10⁶ mm⁴.

  • After =, press Tab and type a unit, such as kN*m, psi or deg, to show the result in it.
  • Switch the sheet between SI and US with the buttons in the title bar.
  • Temperatures are 20°C or 68°F; a difference is 5Δ°C.
  • Format → Units holds your own units, such as kip = 1000*lbf, and the units results are shown in.

Results and design checks

check(σ<=0.9*Fy) is a design check. It shows a green OK or a red NG, and the ratio of the value to its limit, so above 1 always fails. The status bar counts the checks, "3 checks, all OK", and a click goes to the first that fails.

  • Format → Show the working writes a result as a checker wants it: the formula, the values in their places, then the answer.
  • Format → Result sets decimals or significant figures for the sheet, and whether powers of ten are multiples of three (12.35·10³) or any power (1.235·10⁴).
  • View → Traditional notation sets the math as a textbook does, with = to define.

Math wider than the page

Math that would run past the right margin moves left until it ends there. Math wider than the space between the margins is fitted where it is, on screen and on paper alike.

  • A long vector or matrix, typed or a result, shows its first and last columns with ⋯ between them, and how many it leaves out under them: E24 ≔ [1.0 1.1 1.2 ⋯ 7.5 8.2 9.1], "18 more".
  • Format → Show all values, or the region's right-click menu, shows every value instead, in blocks of columns one under another, each with its column numbers over it. It is saved with the worksheet and printed.
  • A long expression breaks before a +, a − or an =, and goes on the next line, in under what follows ≔. With the working shown, the working starts a line of its own.
  • Click such math to edit it whole, in a panel over the paper, every value shown and wrapped to the window. Math you type past the room it has moves into the panel as you type. Enter or Esc leaves it.
  • What still runs past a margin, such as a fraction wider than the page, gets an orange line at the margin and a note when you point at it. Print says which pages it is on, and the answer key always shows every value.

Plots

Type @ on the paper. Above the plot goes what runs up the y-axis, one expression a trace, separated by commas; press Tab and type what runs along the x-axis. That is a range the sheet defines, x:0, 0.1..10, or a name it does not, which runs from −10 to 10. While a plot is open, its settings set each axis's limits, unit and log scale.

Steel shapes

Write S1:section("W310x39"), and the sheet below has the shape's properties by its name: A.S1, Zx.S1, Ix.S1 and the rest, in units. Insert → Steel shape… finds one by family and name. AISC names work in inches (W12x26) and millimeters (W310x38.7), and CSA by CISC's names.

Format → Size this shape… tries the other shapes of the same family, lightest first, and lists the lightest that pass every check on the sheet, each with its governing check. Use puts one in.

The AISC Shapes Database is published free for public use, with no warranty. Check values that matter against the published tables.

Diagrams and drawings

  • Insert → Beam diagram draws a beam to scale and solves it: supports, point and line loads, reactions, shear, moment and, given EI, deflection. Below it, R.A, M.1(x) and Mmax.1 are names like any other.
  • Insert → Frame or truss diagram does the same for plane frames and trusses.
  • Insert → Figure… puts in a ready-made drawing from the examples, with the definitions it is drawn from. Change the values and the figure follows.
  • Insert → Drawing starts your own. Every coordinate and size is an expression, and text shows values written in braces, b = {b}.

Versions of a question

Point at a given's definition and press the ± in the margin, or choose Format → Vary this value…, and give the values it takes: a list, 20°, 30°, 45°, or a range, 5kg, 6kg..20kg. Format → Answer only marks what students' copies leave off. File → Versions draws a set, prints students' copies, worked copies and the answer key, and exports a quiz for Moodle or Canvas.

Show on the paper, in the status bar or beside a version in File → Versions, shows that version worked out on the paper: its values, answers and diagrams. The paper is read-only while it shows, and the regions marked Answer only are faint. ‹ and › step through the set, and Escape goes back to your worksheet.

Saving and printing

  • Save (⌘S) writes a .calcwright file; Open (⌘O) reads one. Each worksheet opens in a tab of its own, and the app keeps your open tabs between runs.
  • File → Page setup chooses the paper, and plain or engineering paper with its title block.
  • Print (⌘P) opens the pages in your browser; choose Save as PDF there for a PDF. Math and plots print as vector drawings.
  • Undo (⌘Z) takes back the last step, from the paper or from any field.

Connect your AI

Calcwright has no AI of its own and never calls an AI service. The desktop app is an MCP server on your computer, so the AI app you already use can read and build worksheets in its window while you watch. You need an AI app that takes MCP servers, and your own account with it.

The AI connection has a 14-day free trial from the first time you open Calcwright. Help → Connect your AI shows the days left. After the trial, your AI cannot use Calcwright until you enter a license key with Help → License, and it tells you so. Everything else in Calcwright stays free.

Claude Desktop

  1. In Calcwright, choose Help → Connect your AI.
  2. Press the button for Claude Desktop. It adds Calcwright to Claude Desktop's settings, keeps the rest of the file, and leaves the old copy beside it as a .bak.
  3. Quit Claude Desktop and open it again.

Claude Code, Codex, Gemini CLI, Cursor and VS Code

Help → Connect your AI gives the line or setting to copy for each. For Claude Code it is a line like this one, with the paths on your computer filled in:

claude mcp add --scope user calcwright -- <app>/Contents/MacOS/cottontail '<app folder>/calcwright-mcp.mjs'

Copy the exact line from the app, not this one: the app writes in the paths for where it is installed.

See that it worked

Under Connected, Connect your AI lists the AI apps that sent a request since Calcwright opened. Then ask your AI something about the sheet in front, such as "What does this worksheet calculate?"

How it connects

  • Each AI app runs a small bridge, calcwright-mcp.mjs, that Calcwright writes into its own folder each time it starts. Nothing else needs to be installed.
  • The bridge opens Calcwright when it is closed, and finds it again after it restarts, so your AI app's settings hold no port and no token.
  • Calcwright serves MCP from this computer only, at 127.0.0.1, with a token kept in a file only you can read. A request without the token, or from a web page, is refused.
  • Your AI can save and open .calcwright files by path. A save that would replace a file other than the worksheet's own asks you first.
  • AIs that run in a web browser, such as claude.ai or ChatGPT in a browser tab, can't reach an app on your computer, so they can't connect.

Prompts

Calcwright offers ready-made prompts, which most AI apps show as slash commands. They carry the method, so you don't need to know it.

PromptDoes
/draw_problemDraws a diagram for a problem you describe or show in a picture
/free_body_diagramFrees a body in the worksheet, or the part you chose
/change_thisDoes what you ask to what you chose
/make_versionsTurns the worksheet into a question with versions, and checks each one
/check_calculationReads the worksheet as a checker would

Choose regions or part of a drawing first, and your AI knows what "this" is. The full list of tools is on the Features page.

Reviewing what your AI changed

Your AI works in turns. Its tool calls one after another are one turn and one step of Undo, so ⌘Z takes back everything it did for one request. A turn ends when you change something, or after 45 seconds of quiet.

Each region your AI made or changed has a violet bar in its left margin until you have looked at it. The status bar says "Your AI changed 3 regions", with Review to go through them one at a time, Undo all while the turn is the last step, and Done to mark them all as seen. The bars are not printed.