Skip to article
Browse chapters

Installation

Build bingo from source with a stable Rust toolchain, and check the binary answers.

Install from source

Prebuilt binaries are available on GitHub Releases. To build from source instead, use the repository and the stable Rust toolchain below.

What you need

  • Rust 1.96 or newer, stable. The workspace is Rust 2024 edition and sets rust-version = "1.96"; rust-toolchain.toml pins the channel to stable and asks for rustfmt and clippy, so rustup selects the right toolchain when you build inside the repository.
  • git, to clone.

Build it

git clone https://github.com/yexrob/bingo
cd bingo
cargo install --path crates/bingo --locked

cargo install puts the bingo binary in cargo’s bin directory, which is ~/.cargo/bin unless you have moved it. Make sure that directory is on your PATH before running bingo. If you would rather keep the build in the tree — while working on bingo itself, for instance — build a release binary instead:

cargo build --release

That leaves the binary at target/release/bingo.

Check it

$ bingo --help
A local coding-agent harness

Usage: bingo [OPTIONS] [PROMPT] [COMMAND]

Commands:
  serve     Serve sessions over JSON-RPC to one client (ADR-0007)
  login     Sign in to a provider; the browser opens unless told otherwise (ADR-0012)
  logout    Forget a provider's stored credential
  provider  Named provider instances: more endpoints than the three built in (ADR-0017)
  channels  Listen on the configured IM channels and nothing else (ADR-0016)
  gateway   One resident bingo per data dir, managed like a service (ADR-0020)
  help      Print this message or the help of the given subcommand(s)

bingo --version prints the build’s version.

Where bingo keeps things

One directory holds everything, under your home directory:

pathwhat lives there
~/.bingo/settings.jsonyour settings, the lowest layer (ADR-0003)
~/.bingo/plugins/<name>/cross-process plugins you installed (ADR-0015)
~/.bingo/skills/<name>/SKILL.mdyour skills (ADR-0009)
~/.bingo/data/auth.jsoncredentials, mode 0600 (ADR-0012)
~/.bingo/data/sessions/<id>/one directory per session: journal.jsonl, .lock, summary.json (ADR-0005)
~/.bingo/data/logs/stderr from MCP servers and plugin processes

A project keeps its own layers beside its code, in .bingo/ — settings, skills and plugins that belong to that repository rather than to you.

Next: the quick start.