Introduction

Agrafe is the Dolfin web app for writing, compiling and deploying ontologies in your browser. This book documents Agrafe itself: its features, screens and integrations.

The Dolfin language (syntax, types, units, the Turtle correspondence) has its own documentation at www.dolfin.fr/docs. Nothing here repeats it.

What is covered

Using Agrafe: from an empty account to a live API.

• Projects: create, organise in folders, share and publish projects.
• The project workspace: the screen you work in, and how its parts fit together.
  • Files: the file tree, its right-click menus, zip import and export.
  • The Dolfin editor: completion, hover, quick fixes and the right-click menu.
  • Problems, hints and quick fixes: what the checker reports and how to fix it in one click.
• The output panel: Parse, Turtle and SVG, the interactive Graph and its right-click menus, the SPARQL console, Deployments and their API, and History.
• Collaboration: roles, editing together, public projects.
• Account settings and Keyboard and mouse.

Turtle projects: start from an existing OWL/Turtle file and keep both worlds connected.

• Importing a Turtle file creates a Dolfin project and keeps the original .ttl in it.
• The Turtle editor edits that file with syntax checking.
• Reveal jumps from a Dolfin declaration to the Turtle it corresponds to, and back.
• Sync writes your Dolfin edits into the Turtle automatically.
• Re-translate regenerates the Dolfin files after you changed the Turtle by hand.

Integrations: query your deployed ontologies from Claude and other MCP clients.

First steps

1. On the Projects page, press + and choose New project.
2. Open it and pick an example, or paste your own Dolfin. See An empty project.
3. Edit. The Problems panel and the Graph follow as you type.
4. Press Deploy and copy your token. See Deployments.

A short guided tour runs the first time you open the Projects page and a project. The ? button in the output panel walks you through its tabs at any time.

Conventions

• Dolfin file or dlf: a .dlf source file of the project.
• Origin: the .ttl a project was imported from (see Importing).
• Menu and button names are written exactly as they appear in the app.
• On a Mac, read ⌘ wherever this book says Ctrl.