get started

Quickstart

Get up and running with brin in under a minute

Install

Bash
npm install -g brin

Or via shell script:

Bash
curl -fsSL https://brin.sh/install.sh | sh

See Installation for other methods.

Initialize your project

Bash
brin init
Bash
  ๐Ÿ”ง initializing brin...
 
  Enable AGENTS.md docs index for AI coding agents? (Y/n) Y
 
  โœ“ created brin.json
  โœ“ created .brin-docs/
  โœ“ updated AGENTS.md with brin docs index
  โœ“ added package installation instructions to AGENTS.md
 
  โœ“ brin initialized successfully!

This creates brin.json, sets up a docs index in .brin-docs/, and adds package installation instructions to AGENTS.md so AI agents automatically use brin add instead of npm install.

Add your first package

Bash
brin add express
Bash
๐Ÿ” checking express@4.21.0...
โœ… not sus
   โ”œโ”€ publisher: expressjs (verified)
   โ”œโ”€ downloads: 32M/week
   โ”œโ”€ cves: 0
   โ””โ”€ install scripts: none
๐Ÿ“ฆ installed
๐Ÿ“ updated AGENTS.md docs index

Next steps