Install

# Start local. Keep memory local.

Fob runs on your machine and calls local AI CLIs only when you ask it to.

## Prerequisites

- macOS or Linux. Windows support needs validation; WSL2 is the safest path for now.
- Node.js 18 or newer.
- Claude Code installed and authenticated for `@claude`.
- Codex CLI installed and authenticated for `@codex`.

## Install and activate

    ./install.sh
    fob login FOB_your_license_key
    cd /path/to/your-project
    fob scan
    fob start

The scan creates local Fob memory inside the project you are working on.

## Open the local website

    fob serve
    # open http://127.0.0.1:8787

The website is local-only by default. It does not expose your project to the public internet.

## Run headless

    fob daemon
    # API docs: http://127.0.0.1:8787/api/docs

Use the daemon when another local tool needs Fob memory, context selection, route jobs, or saved decisions without opening the terminal room.