Bee Box documentation · directory: https://beebox.run/docs/reference/cards/ · index: https://beebox.run/docs/reference/cards/index.md · root: https://beebox.run/llms.txt

# place Card

# Place Cards

Place cards track named places the box should recognize — "Home", "Office",
the gym — so location-aware context ("the boxholder is at Home") works.

They live at `places/<Name>.place.card`. The filename uses the place's name
with underscores.

**Frontmatter:**
- `name:` — The place's name. Required.
- `aliases:` — Array of other names for the place (e.g., ["the house"]).
- `address:` — Freeform human-readable address (street, city). Optional —
  this is the address a person reads; it is *not* the coordinates.
- `lat:` / `lng:` — Center coordinate. **Do not hand-type these** — run
  `bbx location mark <path>` to stamp the boxholder's current device location
  into the card. Both must be set together.
- `radius:` — Match radius in meters (written by `bbx location mark`).
- `status:` — `active` (default), `inactive`, or `archived`.

**Body (markdown):** describe the place and **why it matters in the box** —
e.g. "Home — where the boxholder usually works; default for after-hours context."

**How to record a place (card-first, then mark):**
1. Author the card describing the place (name, address, body). Coordinates can
   be absent at this point.
2. When the boxholder is physically at the place, run
   `bbx location mark places/<Name>.place.card` to stamp the current location.
   It reports the fix's age, so you can judge whether it's current.

`bbx location get` then names the place whenever the boxholder's location falls
within its radius.

**Filename convention:** `places/<Name>.place.card` — use the place's name,
not a slug.

## The `contains:` field

Give this card a one-sentence `contains:` — the prime retrieval field for
`bbx search` and listings. How to write a good one (carry the information when
it's concise, never a list of parts, under 200 characters) is in the agent
guide's ABOUT_CARDS section.

## Templates

### place

A place card — a named location the box can recognize (Home, Office)

```bash
bbx create <path>.place.card -t place
```

Template: place
Description: A place card — a named location the box can recognize (Home, Office)
Card types: place

Arguments:
  name: Name of the place
  aliases (optional): Another name for the place
  address (optional): Human-readable address (street, city)