Installing Auturis

Opening the app the first time, and using it with Claude. To download again, use your personal download link.

Opening it the first time

Your OS will warn you the first time you try to open this app — that's expected, not a sign anything's wrong. Auturis is a beta from an independent developer. It isn't distributed through the App Store or Microsoft Store, and it isn't signed with Apple's or Microsoft's paid developer certificates. Those cost money every year, and I'd rather spend it once there's evidence people want the app. Until then, your computer can't tell who made it, so it errs on the side of caution. Find the section below for what you downloaded; the steps take under a minute.

Windows

  1. Right-click the downloaded zip and choose Extract All — don't just double-click to open it, since Windows lets you browse inside a zip without actually extracting it, and the app won't run correctly from there. If you double-click Auturis.exe without extracting first, Windows will warn "this application may depend on other compressed files in this folder" — that's the sign to go back and extract properly. Once it's extracted to a real folder, run Auturis.exe from inside it, keeping it together with the _internal folder next to it.
  2. Windows will likely show a blue "Windows protected your PC" SmartScreen warning. Click More info, then Run anyway.

Mac (Apple Silicon or Intel)

  1. Safari unzips the download for you. With another browser, double-click the zip in your Downloads folder. Either way you get Auturis.app in Downloads.
  2. Move it to your Applications folder: open a Finder window (the blue smiling face at the left end of the Dock), click Downloads in the sidebar, and drag Auturis.app onto Applications in the same sidebar.
  3. Your Mac will refuse to open it and will very likely only give you the option to put it in the Trash. In order to open it, follow these steps:
    1. Open Terminal (a built-in Mac app, not something you need to install): press Command (⌘) and Space together, a search box will pop up, type Terminal, then press Return. A window with plain text will open — that's normal, it's just how Terminal looks.
    2. Select and copy the line below (click into it, then Command+C):
      xattr -cr /Applications/Auturis.app
      click into the Terminal window, paste it in (Command+V), and press Return. (If you left the app in Downloads, use xattr -cr ~/Downloads/Auturis.app instead.)
      What this does: when you download a file, your Mac attaches a "quarantine" tag to it. This command removes that tag from Auturis.app only — nothing else on your Mac, and it doesn't change any security settings.
    3. Close Terminal, then double-click the app again — it should open normally.

Once it's open: you'll be asked for your own API key on first launch (how to get one; it takes a couple of minutes), or, with a Claude subscription, you can skip the key and use parts of Auturis through Claude instead.

To use Auturis through your Claude subscription, see Using Auturis with Claude.

Using Auturis with your Claude subscription

Install the plug-in to test maxims and rules and to build your tree with Claude; install the extension for Claude to read your tree in an ordinary chat. What each one does.

  1. Install the Auturis app (the steps above) and open it.
  2. Install the part for where you use Claude. You can install both; they don't conflict.
    • The Code tab, or Claude Code in a terminal: the plug-in. In the Claude desktop app's Code tab, add this address under + → Plugins:
      https://auturis.com/plugin/marketplace.json
      In Claude Code in a terminal, give it this command:
      /plugin marketplace add https://auturis.com/plugin/marketplace.json
      then /plugin install auturis@auturis.
    • The ordinary chat: the extension. Download the Auturis extension and open it; the Claude desktop app asks you to confirm. Or, in the Claude desktop app, go to Settings → Extensions and install it from there. It needs Auturis 0.14.0 or later. It doesn't work on claude.ai in a browser, which can't reach your computer.
  3. Each time, open Auturis before Claude. If Claude in the Code tab says the plug-in failed to connect, Auturis wasn't open when the session started: open it, type /mcp, choose auturis, then Reconnect. In the ordinary chat, start Auturis and ask again.

In the Code tab, or Claude Code in a terminal, the plug-in can give Claude your tree for you. Turn on its option “Share my Auturis graph with Claude”: type /plugin configure auturis@auturis. Claude is then given your tree at the start of each session and, with each message you send, the pursuits in it that your words touch. Your graph's text then goes to Anthropic with the conversation, so it is off until you turn it on.

In the ordinary chat, if you want Claude to take your tree into consideration when thinking through some issue, let it know. We have deliberately left the matter to you. If you want Claude to always refer to your tree, you may consider adding a sentence like this to Claude's memory, or to a Project's instructions: “I keep a record of my ends in Auturis. Before you answer a question about a choice of my own, read my Auturis tree.”