bl CLI

Your vault in the terminal

Query your memory, record decisions, and wire up IDE integrations — all from the command line. Works standalone or alongside the BaseLayer Connector.

Install

Homebrew (recommended)
brew install baselayer-id/tap/bl
Shell script
curl -fsSL https://raw.githubusercontent.com/baselayer-id/bl/main/install.sh | bash

Quick Start

1. Sign in
bl auth login
2. Wire up your IDE
bl setup claude
3. Query your vault
bl ask "what am I working on?"

Commands

bl ask

Query your vault — get a synthesized answer with citations.

bl ask "what am I working on?"
bl search

Semantic search across your entities, facts, and conversations.

bl search "auth refactor"
bl remember

Record a decision, preference, or observation to your vault.

bl remember "decided to use PKCE for auth"
bl setup

Install SessionStart hooks so your IDE gets a context primer on every session.

bl setup claude

IDE Hooks

Install SessionStart hooks so your IDE gets a context primer at the start of every session — who you are, what you're working on, and what your vault knows.

Claude Code
bl setup claude
Gemini CLI
bl setup gemini
Verify hook status
bl setup check

Want the full desktop experience?

Download BaseLayer Connector