README.md

What it does

Jot is the first general-purpose System One agent for Jev. Jev chooses tools and arguments. Jot runs the loop: execute, put the real results back into context, ask Jev again until it can reply.

You see every tool call. Credentials stay on the server. Chats stay in this browser.

The loop

You → Jev chooses a tool → execute → tool result → Jev again → reply

You: Add 6 and 7, then multiply by 2.

calculate({ left: "6", operator: "add", right: "7" })  → 13
calculate({ left: "13", operator: "multiply", right: "2" })  → 26

Jot: 26

The calculator does the math. Jev only decides the calls.

Quick start

Needs Node.js, a TypeSafe API key, and Apple Silicon with uv for local drafts.

npm install
cp .env.example .env   # set TYPESAFE_API_KEY
npm run draft:serve    # terminal 1
npm run dev            # terminal 2

Open localhost:3000. Loopback only.

npm test && npm run build

Packages

packages/ui          Chat UI and tool-call trace
packages/agent       Provider-independent loop
packages/jev-core    TypeSafe client and Jev text
server/              HTTP, Jev adapter, tools

UI talks to agent events. The loop does not import React or Jev. The server wires them.

Credits

TypeSafe / Jev · pi · Errand · FrequencyWords · jsRealB

Jot is independent and not affiliated with TypeSafe. Jev is the model name.