AI Study Assistant

Study smarterwith Claude AI

A beautiful CLI study assistant powered by Claude AI. Socratic tutoring, BrainLift knowledge export, optional voice mode, web search — all from one command.

Chat Voice BrainLift History Agent WebSearch
~/terminal
# install
$ curl -fsSL https://dl.csaiautomations.com/brainlifter/install.sh | bash
# start studying
$ brainlifter # new session
$ brainlifter --history # pick a past session
$ brainlifter --continue # resume last session
Chat Socratic AI tutor
Export save_brainlift
Search live web search
Voice Ctrl+V to toggle

Install

One command. No GitHub tokens, no global npm installs.

curl -fsSL https://dl.csaiautomations.com/brainlifter/install.sh | bash click to copy

Requires Node.js 18+ on macOS — the installer will guide you through the rest.

API Keys
Required   ANTHROPIC_API_KEY — get yours at console.anthropic.com
Optional    LIVEKIT_API_KEY, LIVEKIT_API_SECRET, LIVEKIT_URL, GOOGLE_API_KEY — for voice mode

Update: brainlifter --update  •  Uninstall: brainlifter --uninstall

Quick Start

1

Install

Run the one-liner above. The installer checks Node.js, downloads the latest release, and prompts you for API keys.

2

Add API Key

Paste your Anthropic API key when prompted during install. Voice mode keys are optional — skip with Enter if you don't need them.

3

Run brainlifter

Type brainlifter in any terminal to start a new session. Use --history to pick a past one.

4

Start Learning

Ask anything. The AI tutor will guide you with Socratic questions. Use save_brainlift to export what you learned.

Features

🧠

Claude AI Tutor

Powered by Claude via the Anthropic Agent SDK. Deep understanding, real reasoning — not just pattern matching. Uses Socratic method to guide you to answers, not hand them over.

📚

BrainLift Export

Structured DOK1-DOK4 knowledge export. Use save_brainlift anytime to save what you've learned as a well-structured JSON file you can reference later.

🌐

Live Web Search

The AI agent automatically searches the web for current information. No stale training data when you're studying recent events, papers, or documentation.

🎤

Voice Mode

Hands-free studying via LiveKit and Gemini Realtime API. Toggle with Ctrl+V. Requires optional LiveKit + Google API keys.

📂

Conversation History

Every session is automatically saved. Pick up exactly where you left off with brainlifter --history or jump back to the last session with --continue.

Go-Powered TUI

Native Go terminal UI with real scrolling, no flicker, 10x faster startup and 5x less memory than browser-based alternatives. Keyboard-first, distraction-free interface.

Commands

brainlifterStart a new study session
brainlifter --continueResume the last session exactly where you left off
brainlifter --historyInteractive picker — browse and load any past session
brainlifter --updateSelf-update to the latest version
brainlifter --uninstallRemove brainlifter and all its files
Ctrl+T (in-app)Toggle Agent SDK ↔ Direct API mode
Ctrl+V (in-app)Toggle voice mode (requires LiveKit setup)
Ctrl+C (in-app)Exit and save the current session