Clone the repository and install dependencies:

git clone <repo-url>
cd second-brain
uv sync

Capture a quick thought:

uv run second_brain new "My brilliant idea about caching"

This creates ~/second_brain/2026-03-22-my-brilliant-idea-about-caching.md with a heading and timestamp. Duplicate titles on the same day get a numeric suffix (-1, -2, …) to avoid overwriting.

List all notes:

uv run second_brain list

Show a note's content:

uv run second_brain show 1

With dev environment variables:

uv run --env-file .env second_brain new "Some thought"

Via Python module:

uv run python -m second_brain new "Some thought"

.env.example is the committed template — copy it to .env for development:

cp .env.example .env

Note: uv run --env-file .env loads the dev environment explicitly (no auto-loading).

Console output uses a compact format with 3-letter level codes (INF, DBG, WRN, etc.). See the Usage Guide for details.

Run tests:

uv run pytest

Run tests with coverage:

uv run pytest --cov

Preview docs locally:

uv run python scripts/serve_docs.py

Build static docs:

uv run mkdocs build