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)

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)