Documentation

Getting Started

Welcome to the Brain API documentation. This guide will help you integrate Brain's AI capabilities into your application.

Quick Start

Get up and running in 5 minutes:

bash

# Install the Brain SDK
npm install @brain/sdk

# Or with yarn
yarn add @brain/sdk

Initialization

javascript

import { Brain } from '@brain/sdk';

const brain = new Brain({
  apiKey: process.env.BRAIN_API_KEY,
});

// Create your first task
const task = await brain.tasks.create({
  title: 'Review Q4 goals',
  priority: 'high',
  dueDate: '2026-03-15',
});

console.log(task);

Key Concepts

Tasks

The basic unit of work in Brain. Tasks can have priorities, due dates, attachments, and subtasks.

Notes

Rich text documents with markdown support. Notes can be linked to tasks and organized in folders.

Agents

AI-powered workers that execute tasks automatically. Configure agents to triage, summarize, and act on your behalf.

API Reference

For complete API details, visit our API Reference.

GET /tasks POST /tasks GET /notes POST /notes GET /agents POST /agents/:id/run