office-cli 0.1.0

Office — CLI to manage sittings and meeting rooms in office maps.

office

Agent-first CLI for managing seat assignments and meeting rooms across office floor plans. Floor layouts are hand-traced SVGs; people come from BambooHR; assignments live in a Google Sheet (v1) or DynamoDB (v2). The CLI exposes the same operations as the Slack /whereis command and the web map.

Status — v0.1.0. Stage 1 of the v1 seating system is in: floor SVG parser/validator, CSV-backed assignment store with append-only audit log, and CLI verbs (floors, seats, whereis). Google Sheets, BambooHR, Slack /whereis, and the web map land in later stages on top of the same office_cli.seats service. See issue #1.

Naming surfaces

office uses three different identifiers across packaging surfaces. Mind the split — do not blanket-replace one token across the codebase.

Surface	Value
GitHub repo	agentculture/office-agent
PyPI distribution	office-cli
Python package	office_cli
CLI binary	office
Error class prefix	Office

Install

uv tool install office-cli
office --version

Use

office learn                                    # self-teaching prompt
office explain seats                            # markdown docs for any verb
office whoami --json                            # auth probe (stub)

# v0.1.0 seating verbs:
office floors list --json
office floors validate floors/tlv-floor-5.svg
office seats list --vacant
office seats assign 5-T-01 [e-mail]
office seats move [e-mail] 5-T-02
office seats history 5-T-01 --json
office whereis [e-mail]

office reads data/offices.yaml, floors/, and seats/ from the current working directory. Override with --data-dir DIR or OFFICE_DATA_DIR=DIR.

Adding a new floor

1. Trace the floor in Inkscape following docs/tracing-guide.md and the SVG ID contract in CLAUDE.md. Save as Plain SVG.
2. Drop the SVG into floors/ as <office>-floor-<N>.svg.
3. Add an entry to data/offices.yaml with cluster capacities and any named rooms.
4. Verify: office floors validate floors/<file>.svg. Errors fail the command; warnings (e.g. cluster-capacity mismatches) are informational.

Develop

uv sync
uv run pytest -n auto -v
uv run office --version
uv run python -m office_cli

License

MIT — see LICENSE.