THUFIR

Your Repository's Mentat

"It is by will alone I set my mind in motion."

Get Your Token

Choose Your Sietch

"Every sietch has its own ways. Choose wisely."

Prepare Your Tools

The Mentat requires certain instruments

1

Claude Code

First, get a Claude Code subscription ($20/mo). Once you have it, run these two commands — the first installs the Claude Code CLI, and the second opens your browser to log in with your Anthropic account:

npm install -g @anthropic-ai/claude
claude auth login

Requires Node.js (v18+) — npm is included when you install Node.

2

GitHub CLI

Your AI colleague uses GitHub to manage code. Install the GitHub CLI, then log in — it will open your browser to authenticate with GitHub:

brew install gh
gh auth login

If brew is not recognized, install Homebrew first: brew.sh

Don't have a GitHub account? Create one here — it's free.

3

Create Your Project

Create a new folder for your project and initialize it as a git repository. Replace my-project with whatever you'd like to name it:

mkdir my-project && cd my-project
git init
4

Typeless (Optional)

Download and install Typeless for speech-to-text.

Once installed, click into your terminal where Claude Code is running, tap the Fn key (bottom-left of your keyboard) once, and start speaking. Typeless captures up to 9 minutes of speech and sends it directly to the agent as text. Tap Fn again to stop.

This is especially useful for brain dumps — describing your project, glossary, or taxonomy in your own words. The agent will make sense of it and structure it for you.

Activate Your Mentat

Initialize your repository's intelligence

1

Run the Installer

Make sure you're inside your project folder (from Step 3), then run this command. npx downloads and runs the installer without a permanent install. It will ask for your token — paste the one from the "Get Your Token" page:

npx thufir init

If npx is not recognized, you need to install Node.js first (same prerequisite as Claude Code).

2

Validate Claude

Confirm Claude Code is installed and working. You should see a version number like 1.x.x:

claude --version

If you see "command not found," go back to Slide 3 Step 1 and re-run the npm install command. On Windows, try closing and reopening your terminal first.

3

Say Hello

Start Claude Code and talk to your new AI colleague. That's it — you're ready for the workshop:

claude