# tempono

[tempono](https://tempono.com) makes enrichment bundles for gifted pupils in
Dutch primary schools: a booklet, answer sheets, a teacher manual and an
answer key, all from one YAML bundle.

This is tempono for a teacher's assistant (Claude, Codex, …) working in a
folder on the teacher's computer. Each of the teacher's workspaces is a
folder there, `Mijn materiaal (K7Q2XM)/`, whose bundles and plannings sync
both ways with tempono; bundles in `local/` stay on the computer,
next to whatever notes and research the assistant keeps there. New kinds of
blocks and answer fields (plugins) are written in `plugins/`, and the
bundles there use them at once. Checking a bundle or a plugin, drawing its
pages, the image library and the documentation all run locally.

The teacher doesn't need a terminal: their assistant runs this.

## As an MCP server

For assistants that reach the computer through MCP. Give it the folder (a
full path; it is made if it isn't there):

```json
{
  "mcpServers": {
    "tempono": {
      "command": "npx",
      "args": ["-y", "tempono@latest", "mcp", "/Users/name/Documents/tempono"]
    }
  }
}
```

The server explains itself to the assistant. Its `login` tool opens a page
in the teacher's browser where they log in and allow access.

## As a command

For assistants with a shell. In the folder:

```sh
npx tempono login          # https://app.tempono.com; the teacher logs in in the browser
npx tempono docs spec      # how a bundle is written
npx tempono sync           # bundles/ <-> the teacher's drafts
npx tempono validate <bundle>
npx tempono render <bundle>   # pages as PNG in .tempono/out/
npx tempono serve          # watch the bundles live on localhost while they change
npx tempono assets tornado # find an image in the library
npx tempono plugin new anna/badge     # a plugin to start from, in plugins/anna/badge/
npx tempono plugin check anna/badge   # its checks, tests and example pages
npx tempono plugin save anna/badge    # into the teacher's workspace
```

`plugins/plugin-api.d.ts` has the types a plugin is written against.

`npx tempono` lists everything.

## How it works

The CLI is a small shell. `login` downloads tempono's engine from the
environment (checked against its hashes), so it always checks bundles the
way that environment does. Node 20 or newer.
