@kitlangton/motel 0.1.0 → 0.1.2

package/AGENTS.md

@@ -2,8 +2,14 @@
 
 ## Commands
 - Install deps: `bun install`
-- Run the TUI: `bun run dev` or `bun run start`
-- Run the local server only: `bun run server`
+- Run the TUI: `bun run dev` or `bun run start` (auto-ensures a managed
+  OTLP daemon is running in the background so traces ingest while the TUI
+  is up)
+- Start the background daemon only: `bun run daemon` (same as `motel start`)
+- Stop the managed daemon: `bun run stop`
+- Daemon status JSON: `bun run status`
+- Restart daemon + relaunch TUI: `bun run restart`
+- Run the local server in the foreground (no daemon, no TUI): `bun run server`
 - Run tests: `bun run test`
 - Query services via CLI: `bun run cli services`
 - Query traces via CLI: `bun run cli traces <service> [limit]`
@@ -36,6 +42,7 @@
 - `/api/ai/calls` searches AI SDK calls (streamText, generateText, etc.) with first-class filters for `model`, `provider`, `sessionId`, `functionId`, `operation`, `status`, `text` (cross-field search), and returns compact summaries with previews and token usage.
 - `/api/ai/calls/<span-id>` returns the full detail of a single AI call including complete prompt messages, response text, tool calls, timing, and correlated logs.
 - `/api/ai/stats` aggregates AI call statistics by `provider`, `model`, `functionId`, `sessionId`, or `status` with aggregations: `count`, `avg_duration`, `p95_duration`, `total_input_tokens`, `total_output_tokens`.
+- `/api/facets?type=traces&field=attribute_keys&service=<svc>` lists span-attribute keys for a service, ranked by discriminating power (keys with many distinct values first). Pair with `field=attribute_values&key=<key>` to list values for a specific key. Used by the TUI `f` attribute filter.
 - `/api/docs` lists available documentation; `/api/docs/debug` and `/api/docs/effect` return the full skill content.
 
 ## Architecture
@@ -48,11 +55,16 @@
   (pane widths, body lines, viewport rows, drill-in level).
 - `src/ui/app/TraceWorkspace.tsx` renders the drill-in state machine:
   L0 (trace list), L1 (waterfall), L2 (span detail), plus the service
-  logs side mode.
-- `src/ui/app/TraceListPane.tsx` wraps `TraceList` in a scrollbox with
-  the filter bar and list header.
-- `src/ui/TraceList.tsx` renders trace rows (trace id, duration, span
-  count, relative age).
+  logs side mode. When drilled in the list is hidden entirely and the
+  detail pane(s) expand to fill.
+- `src/ui/app/TraceListPane.tsx` hosts the trace list: header + optional
+  filter bar + virtual-windowed body (no opentui scrollbox — that had a
+  race with Yoga layout timing).
+- `src/ui/TraceList.tsx` exports `TraceListHeader` (the `TRACES 100 · ...`
+  strip) and `TraceListBody` (virtual-windowed rows with mouse-wheel
+  scrolling). The body owns its own scrollOffset state, preserves the
+  selected row's visual position across auto-refresh shifts, and snaps
+  the window to follow selection that moves off-screen.
 - `src/ui/Waterfall.tsx` renders the waterfall timeline with a
   virtualised scroll viewport; `src/ui/waterfallNav.ts` is the pure
   collapse/expand/walk resolver (unit-tested).
@@ -116,7 +128,7 @@
 - `MOTEL_OTEL_TRACE_LIMIT`: defaults to `100`
 - `MOTEL_OTEL_LOG_LIMIT`: defaults to `80`
 - `MOTEL_OTEL_RETENTION_HOURS`: defaults to `168` (7d)
-- `MOTEL_OTEL_MAX_DB_SIZE_MB`: defaults to `256` (size-based retention cap)
+- `MOTEL_OTEL_MAX_DB_SIZE_MB`: defaults to `1024` (size-based retention cap)
 
 ## TUI Keys
 - `?`: toggle shortcut help
@@ -133,7 +145,9 @@
 - `tab`: toggle service logs view
 - `[` / `]`: switch services
 - `s`: cycle sort mode (recent → slowest → errors)
+- `t`: cycle theme (motel-default → tokyo-night → catppuccin)
 - `/`: enter filter mode (type to match on root operation name; `:error` restricts to failing traces)
+- `f`: open attribute filter picker (browse span-attribute keys → values for the current service; `backspace` walks back to keys; `esc` in the trace list clears the active filter)
 - `a`: pause or resume auto-refresh
 - `r`: refresh now
 - `c`: copy setup instructions for another Effect app

package/README.md

@@ -1,199 +1,106 @@
 # motel
 
-A local OpenTelemetry ingest + TUI viewer for development, backed by SQLite.
-Point your app's OTLP/HTTP exporters at the local motel server and browse
-traces, spans, and logs from a terminal or the built-in web UI.
+A local OpenTelemetry ingest + TUI viewer for development, backed by
+SQLite. Point your app's OTLP/HTTP exporters at the local motel server
+and debug with real runtime evidence — from a terminal, the built-in web
+UI, or directly from an AI coding agent.
 
-## Install
+## For agents: install the motel-debug skill
 
-```bash
-bun add -g @kitlangton/motel
-motel
-```
-
-(or `bunx @kitlangton/motel` for a one-off run without installing.)
-
-## Requirements
-
-- [Bun](https://bun.sh/) — v1.1 or newer
-
-## Install the motel-debug skill
-
-`motel` ships a companion skill that teaches agents (Claude Code, OpenCode,
-Cursor, Codex, and 40+ others) how to debug with runtime evidence by
-querying motel's local OTLP store. Install it with a one-liner via
-[`npx skills`](https://github.com/vercel-labs/skills):
+`motel` ships a companion skill that teaches Claude Code, OpenCode,
+Cursor, Codex, and 40+ other agents how to debug with runtime evidence
+by querying motel's local OTLP store. Install it once and any future
+agent session in the project will know how to use it.
 
 ```bash
 # Project-local (adds to .claude/skills, .agents/skills, etc.)
 npx skills add kitlangton/motel --skill motel-debug
 
-# Globally, available in every project
+# Or globally, for every project
 npx skills add kitlangton/motel --skill motel-debug -g
-
-# Target a specific agent only
-npx skills add kitlangton/motel --skill motel-debug -a claude-code
 ```
 
-The skill lives at [`skills/motel-debug/`](skills/motel-debug/) in this repo.
-
-## Quick start
+See the full skill at [`skills/motel-debug/SKILL.md`](skills/motel-debug/SKILL.md).
 
-```bash
-bun install
-bun run dev
-```
-
-`bun run dev` starts the local OTLP ingest server (on `http://127.0.0.1:27686`)
-and launches the TUI. Press `?` once inside for the keyboard cheat sheet, or
-`c` to copy paste-ready setup instructions for another Effect/OTEL app.
+## For humans: install and run the TUI
 
-If you just want the server without the TUI (for example, to run it in the
-background and browse the web UI):
+motel is distributed on npm as `@kitlangton/motel`. The binary is a Bun
+script, so Bun must be on your `PATH` at runtime:
 
 ```bash
-bun run server
-# then in another terminal
-bun run web:dev
-```
-
-## Commands
-
-- `bun install`
-- `bun run server`
-- `bun run dev`
-- `bun run test`
-- `bun run cli services`
-- `bun run cli traces <service>`
-- `bun run cli span <span-id>`
-- `bun run cli search-traces <service> [operation]`
-- `bun run cli trace-stats <groupBy> <agg> [service]`
-- `bun run cli logs <service>`
-- `bun run cli search-logs <service> [body]`
-- `bun run cli log-stats <groupBy> [service]`
-- `bun run cli trace-logs <trace-id>`
-- `bun run cli facets <traces|logs> <field>`
-- `bun run instructions`
-- `bun run typecheck`
+# one-off (no install)
+bunx @kitlangton/motel
 
-## Local ports
-
-This repo uses one local Bun server with SQLite storage. No Docker is required.
-
-- motel local API / UI base: `http://127.0.0.1:27686`
-- OTLP HTTP traces: `http://127.0.0.1:27686/v1/traces`
-- OTLP HTTP logs: `http://127.0.0.1:27686/v1/logs`
-- health: `http://127.0.0.1:27686/api/health`
-
-Other local apps can send telemetry to:
+# or install globally
+bun add -g @kitlangton/motel
+motel
 
-```bash
-http://127.0.0.1:27686/v1/traces
-http://127.0.0.1:27686/v1/logs
+# npm also works (Bun still required to run it)
+npm install -g @kitlangton/motel
 ```
 
-Agents and scripts can query traces and logs from the local API:
+Don't have Bun?
 
 ```bash
-http://127.0.0.1:27686/api/services
-http://127.0.0.1:27686/api/traces?service=<service>&limit=20&lookback=1h
-http://127.0.0.1:27686/api/traces/search?service=<service>&operation=proxy&status=error&attr.sessionID=<session-id>
-http://127.0.0.1:27686/api/traces/stats?groupBy=operation&agg=p95_duration&service=<service>
-http://127.0.0.1:27686/api/spans/<span-id>
-http://127.0.0.1:27686/api/spans/<span-id>/logs
-http://127.0.0.1:27686/api/spans/search?service=<service>&operation=Format.file&parentOperation=Tool.write&attr.sessionID=<session-id>
-http://127.0.0.1:27686/api/traces/<trace-id>/spans
-http://127.0.0.1:27686/api/logs?service=<service>&body=proxy_request
-http://127.0.0.1:27686/api/logs?service=<service>&attr.service.name=<service>
-http://127.0.0.1:27686/api/logs/stats?groupBy=severity&agg=count&service=<service>
-http://127.0.0.1:27686/api/facets?type=logs&field=severity
-http://127.0.0.1:27686/openapi.json
-http://127.0.0.1:27686/docs
+curl -fsSL https://bun.sh/install | bash
 ```
 
-## TUI keys
-
-- `?`: show or hide keyboard shortcut help
-- `j` / `k` or `up` / `down`: move selection
-- `ctrl-n` / `ctrl-p`: switch traces even while in trace details
-- `gg` or `home`: jump to the first trace or first span
-- `G` or `end`: jump to the last trace or last span
-- `ctrl-u` / `pageup`: move up by one page
-- `ctrl-d` / `pagedown`: move down by one page
-- `l`: toggle service logs mode
-- `[` / `]`: switch service
-- `enter`: enter span navigation or open selected span detail
-- `esc`: leave span detail or span navigation
-- `r`: refresh
-- `c`: copy a paste-ready Effect setup prompt for another app
-- `o`: open selected trace in browser
-- `q`: quit
-
-## How It Works
-
-`motel` now has one local service process:
-
-- the local Bun server receives OTLP traces and logs on `http://127.0.0.1:27686`
-- it stores telemetry in SQLite at `.motel-data/telemetry.sqlite`
-- it exposes query endpoints on the same base URL
-
-So yes: another service has to point its OTEL exporters at this local motel instance.
-
-## Privacy Note
-
-`motel` is a local observability tool, and it can store sensitive telemetry content if the upstream app emits it.
+`motel` starts the local OTLP ingest server on
+`http://127.0.0.1:27686` and launches the TUI. Press `?` once inside for
+the keyboard cheat sheet, or `c` to copy paste-ready setup instructions
+for any Effect/OTEL app you want to trace.
 
-- correlated logs may include secrets, tokens, or PII if your app logs them
-- AI call data may include prompt previews, response previews, full prompt content, response text, tool metadata, and provider metadata
-- treat the local SQLite store as sensitive development data when using motel against real workloads
+Requirements: [Bun](https://bun.sh/) v1.1 or newer.
 
-The easiest flow is:
+## How your app connects
 
-1. Run `bun run dev` here. That starts the local server if needed and then launches the TUI.
-2. In `motel`, press `c`.
-3. Paste the copied instructions into an agent working in the other service.
-4. Have that service export OTEL traces to `http://127.0.0.1:27686/v1/traces` and OTEL logs to `http://127.0.0.1:27686/v1/logs`.
-5. Refresh `motel`, switch to that service with `[` / `]`, and use `l` or `enter` to inspect logs under a trace or span.
+Once motel is running, point your app's OTLP/HTTP exporters at these
+local endpoints:
 
-## For Agents
-
-An agent does not need to talk to the TUI.
+```
+http://127.0.0.1:27686/v1/traces
+http://127.0.0.1:27686/v1/logs
+```
 
-List and search endpoints now return a `meta` object with `limit`, `lookback`, `returned`, `truncated`, and `nextCursor` so callers can page safely instead of assuming they received all results.
+Motel keeps everything in a local SQLite database at
+`.motel-data/telemetry.sqlite`. No Docker, no cloud account.
 
-Use one of these:
+## How agents connect
 
-1. motel HTTP API directly
+Agents with the `motel-debug` skill installed will automatically use
+motel's HTTP API. The full OpenAPI spec is at
+`http://127.0.0.1:27686/openapi.json` — the key endpoints are:
 
-```bash
-curl http://127.0.0.1:27686/api/services
-curl "http://127.0.0.1:27686/api/traces?service=my-service&limit=20&lookback=1h"
-curl http://127.0.0.1:27686/api/traces/<trace-id>
 ```
-
-2. The local CLI wrapper in this repo
-
-```bash
-bun run cli services
-bun run cli traces my-service 20
-bun run cli span <span-id>
-bun run cli trace-spans <trace-id>
-bun run cli search-spans my-service Format.file parent=Tool.write attr.sessionID=sess_123
-bun run cli search-traces my-service proxy attr.sessionID=sess_123
-bun run cli trace-stats operation p95_duration my-service attr.modelID=gpt-5.4
-bun run cli trace <trace-id>
-bun run cli logs my-service
-bun run cli search-logs my-service timeout attr.tool=search
-bun run cli log-stats severity my-service attr.tool=search
-bun run cli trace-logs <trace-id>
-bun run cli span-logs <span-id>
-bun run cli facets logs severity
-bun run instructions
+GET /api/health                              liveness check
+GET /api/services                            services reporting telemetry
+GET /api/traces?service=<service>            recent traces for a service
+GET /api/traces/<trace-id>                   full trace tree
+GET /api/spans/<span-id>                     single span + logs
+GET /api/logs?service=<service>              recent logs
+GET /api/traces/search?...                   structured trace search
+GET /api/logs/search?...                     structured log search
+GET /api/ai/calls                            AI SDK call inspector
 ```
 
-Recommended shape going forward:
+## TUI keys
 
-1. Keep motel as the single ingest point for apps.
-2. Keep SQLite as the local source of truth.
-3. Keep `motel` as the interactive viewer.
-4. Keep the CLI and HTTP API as the agent/script interfaces.
+- `?` — keyboard cheat sheet
+- `j` / `k` or `↑` / `↓` — move selection
+- `enter` / `esc` — drill in / back out (trace → waterfall → span detail)
+- `[` / `]` — switch service
+- `tab` — toggle service logs
+- `/` — filter traces
+- `s` — cycle sort (recent → slowest → errors)
+- `t` — cycle theme
+- `c` — copy paste-ready setup instructions for another app
+- `o` — open selected trace in the browser
+- `q` — quit
+
+## Privacy note
+
+motel is a local development tool, but your app can emit sensitive
+telemetry. Correlated logs may include secrets, tokens, or PII if your
+app logs them; AI call traces may include full prompt content and
+response text. Treat the local SQLite store as sensitive development
+data when pointing motel at real workloads.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitlangton/motel",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A local OpenTelemetry ingest + TUI viewer for development, backed by SQLite.",
   "type": "module",
   "license": "MIT",
@@ -23,7 +23,9 @@
     "effect",
     "opentui"
   ],
-  "workspaces": ["web"],
+  "workspaces": [
+    "web"
+  ],
   "engines": {
     "bun": ">=1.1.0"
   },
@@ -48,6 +50,7 @@
     "daemon": "bun run src/motel.ts daemon",
     "status": "bun run src/motel.ts status",
     "stop": "bun run src/motel.ts stop",
+    "restart": "bun run src/motel.ts restart",
     "server": "bun run src/motel.ts server",
     "mcp": "bun run src/mcp.ts",
     "test": "bun test",

package/src/App.tsx

@@ -1,16 +1,26 @@
-import { RGBA, TextAttributes, type ScrollBoxRenderable } from "@opentui/core"
+import { RGBA, TextAttributes } from "@opentui/core"
 import { useAtom } from "@effect/atom-react"
 import { useTerminalDimensions } from "@opentui/react"
-import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from "react"
-import { formatTimestamp, traceRowId } from "./ui/format.ts"
+import { useCallback, useEffect, useMemo, useRef } from "react"
+import { formatTimestamp } from "./ui/format.ts"
 import { Divider, FooterHints, HelpModal, PlainLine, SplitDivider, TextLine } from "./ui/primitives.tsx"
 import { useAppLayout } from "./ui/app/useAppLayout.ts"
 import { useTraceScreenData } from "./ui/app/useTraceScreenData.ts"
 import { TraceWorkspace } from "./ui/app/TraceWorkspace.tsx"
-import { noticeAtom, persistSelectedTheme, selectedThemeAtom } from "./ui/state.ts"
+import {
+	attrPickerIndexAtom,
+	attrPickerInputAtom,
+	attrPickerModeAtom,
+	attrFacetStateAtom,
+	noticeAtom,
+	persistSelectedTheme,
+	selectedThemeAtom,
+} from "./ui/state.ts"
 import { applyTheme, colors, SEPARATOR, themeLabel } from "./ui/theme.ts"
 import { getVisibleSpans } from "./ui/Waterfall.tsx"
 import { useKeyboardNav } from "./ui/useKeyboardNav.ts"
+import { AttrFilterModal } from "./ui/AttrFilterModal.tsx"
+import { useAttrFilterPicker } from "./ui/useAttrFilterPicker.ts"
 
 export const App = () => {
 	const { width, height } = useTerminalDimensions()
@@ -36,11 +46,18 @@ export const App = () => {
 		autoRefresh,
 		filterMode,
 		filterText,
+		activeAttrKey,
+		activeAttrValue,
 		traceSort,
 		selectedTraceSummary,
 		selectedTrace,
 		filteredTraces,
 	} = useTraceScreenData()
+	const [pickerMode] = useAtom(attrPickerModeAtom)
+	const [pickerInput] = useAtom(attrPickerInputAtom)
+	const [pickerIndex] = useAtom(attrPickerIndexAtom)
+	const [attrFacets] = useAtom(attrFacetStateAtom)
+	useAttrFilterPicker(activeAttrKey)
 
 	const layout = useAppLayout({ width, height, notice, detailView, selectedSpanIndex })
 	const {
@@ -61,7 +78,6 @@ export const App = () => {
 	} = layout
 
 	const noticeTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null)
-	const traceListScrollRef = useRef<ScrollBoxRenderable | null>(null)
 
 	const flashNotice = (message: string) => {
 		if (noticeTimeoutRef.current !== null) {
@@ -83,27 +99,6 @@ export const App = () => {
 		persistSelectedTheme(selectedTheme)
 	}, [selectedTheme])
 
-	useLayoutEffect(() => {
-		const box = traceListScrollRef.current
-		const traceId = selectedTraceSummary?.traceId
-		if (!box || !traceId) return
-		const indexInList = filteredTraces.findIndex((trace) => trace.traceId === traceId)
-		if (indexInList < 0) return
-		const currentTop = box.scrollTop
-		const viewportRows = Math.max(1, traceViewportRows)
-		let nextTop = currentTop
-		if (indexInList < currentTop) {
-			nextTop = indexInList
-		} else if (indexInList >= currentTop + viewportRows) {
-			nextTop = indexInList - viewportRows + 1
-		}
-		const maxTop = Math.max(0, filteredTraces.length - viewportRows)
-		nextTop = Math.max(0, Math.min(nextTop, maxTop))
-		if (nextTop !== currentTop) {
-			box.scrollTop = nextTop
-		}
-	}, [filteredTraces, selectedTraceIndex, selectedTraceSummary?.traceId, traceSort, traceViewportRows])
-
 	const { spanNavActive } = useKeyboardNav({
 		selectedTrace,
 		filteredTraces,
@@ -117,12 +112,15 @@ export const App = () => {
 
 	const headerServiceLabel = selectedTraceService ?? "none"
 	const autoLabel = autoRefresh ? "● live" : "○ paused"
+	const attrFilterLabel = activeAttrKey && activeAttrValue
+		? `  [${activeAttrKey}=${activeAttrValue.length > 20 ? `${activeAttrValue.slice(0, 19)}…` : activeAttrValue}]`
+		: ""
 	const headerRight = traceState.fetchedAt
 		? `${autoLabel}  ${formatTimestamp(traceState.fetchedAt)}`
 		: traceState.status === "loading"
 			? "loading traces..."
 			: ""
-	const headerLeftLen = "MOTEL".length + SEPARATOR.length + headerServiceLabel.length
+	const headerLeftLen = "MOTEL".length + SEPARATOR.length + headerServiceLabel.length + attrFilterLabel.length
 	const headerGap = Math.max(2, headerFooterWidth - headerLeftLen - headerRight.length)
 	const visibleFooterNotice = footerNotice
 
@@ -168,6 +166,7 @@ export const App = () => {
 					<span fg={colors.muted} attributes={TextAttributes.BOLD}>MOTEL</span>
 					<span fg={colors.separator}>{SEPARATOR}</span>
 					<span fg={colors.muted}>{headerServiceLabel}</span>
+					{attrFilterLabel ? <span fg={colors.accent} attributes={TextAttributes.BOLD}>{attrFilterLabel}</span> : null}
 					<span fg={colors.muted}>{" ".repeat(headerGap)}</span>
 					<span fg={colors.muted} attributes={TextAttributes.BOLD}>{headerRight}</span>
 				</TextLine>
@@ -181,7 +180,6 @@ export const App = () => {
 				filterMode={filterMode}
 				filterText={filterText}
 				traceListProps={traceListProps}
-				traceListScrollRef={traceListScrollRef}
 				selectedTraceService={selectedTraceService}
 				serviceLogState={serviceLogState}
 				selectedServiceLogIndex={selectedServiceLogIndex}
@@ -212,6 +210,18 @@ export const App = () => {
 				</>
 			) : null}
 			{showHelp ? <HelpModal width={width ?? 100} height={height ?? 24} autoRefresh={autoRefresh} themeLabel={themeLabel(selectedTheme)} onClose={() => setShowHelp(false)} /> : null}
+			{pickerMode !== "off" ? (
+				<AttrFilterModal
+					width={width ?? 100}
+					height={height ?? 24}
+					mode={pickerMode}
+					input={pickerInput}
+					selectedIndex={pickerIndex}
+					selectedKey={activeAttrKey}
+					state={attrFacets}
+					onClose={() => { /* handled via keyboard */ }}
+				/>
+			) : null}
 		</box>
 	)
 }

package/src/config.ts

@@ -34,6 +34,6 @@ export const config = {
 		traceFetchLimit: parsePositiveInt(process.env.MOTEL_OTEL_TRACE_LIMIT, 100),
 		logFetchLimit: parsePositiveInt(process.env.MOTEL_OTEL_LOG_LIMIT, 80),
 		retentionHours: parsePositiveInt(process.env.MOTEL_OTEL_RETENTION_HOURS, 168),
-		maxDbSizeMb: parsePositiveInt(process.env.MOTEL_OTEL_MAX_DB_SIZE_MB, 256),
+		maxDbSizeMb: parsePositiveInt(process.env.MOTEL_OTEL_MAX_DB_SIZE_MB, 1024),
 	},
 } as const

package/src/httpApi.ts

@@ -310,7 +310,10 @@ export const MotelHttpApi = HttpApi.make("MotelTelemetry")
 							Schema.annotateKey({ description: "Data source to facet: 'traces' facets span columns, 'logs' facets log columns" }),
 						),
 						field: Schema.String.pipe(
-							Schema.annotateKey({ description: "Column to facet. Traces: service, operation, status. Logs: service, severity, scope" }),
+							Schema.annotateKey({ description: "Column to facet. Traces: service, operation, status, attribute_keys, attribute_values. Logs: service, severity, scope. For attribute_values, also pass key=<attribute-name>." }),
+						),
+						key: Schema.optionalKey(Schema.String).pipe(
+							Schema.annotateKey({ description: "Attribute key to get values for (required when field=attribute_values)." }),
 						),
 						service: ServiceParam,
 						lookback: LookbackParam,
@@ -320,7 +323,7 @@ export const MotelHttpApi = HttpApi.make("MotelTelemetry")
 					error: ErrorResponse,
 				})
 					.annotate(OpenApi.Summary, "Get facet value counts")
-					.annotate(OpenApi.Description, "Returns distinct values and their counts for a given field, useful for discovering what data exists before querying. For example: ?type=logs&field=severity returns the distribution of log levels."),
+					.annotate(OpenApi.Description, "Returns distinct values and their counts for a given field, useful for discovering what data exists before querying. Examples: ?type=logs&field=severity returns log level distribution; ?type=traces&field=attribute_keys&service=opencode lists top span attribute keys; ?type=traces&field=attribute_values&key=ai.model.id lists values seen for that key."),
 
 				// AI Call endpoints
 				HttpApiEndpoint.get("aiCalls", "/api/ai/calls", {

package/src/localServer.ts

@@ -504,6 +504,7 @@ const TelemetryGroupLive = HttpApiBuilder.group(
 							type,
 							field,
 							serviceName: url.searchParams.get("service"),
+							key: url.searchParams.get("key"),
 							lookbackMinutes: parseLookbackMinutes(url.searchParams.get("lookback"), config.otel.traceLookbackMinutes),
 							limit: parseLimit(url.searchParams.get("limit"), 20),
 						}),

package/src/motel.ts

@@ -36,6 +36,17 @@ case "stop": {
 	break
 }
 
+case "restart": {
+	// Stop any running managed daemon, then start a fresh one + launch the
+	// TUI. Handy during local development when you've rebuilt the server
+	// and want the TUI to reconnect to the new binary in one command.
+	await run(stopManagedDaemon)
+	await run(applyManagedDaemonEnv)
+	await run(ensureManagedDaemon)
+	await import("./index.js")
+	break
+}
+
 case "server": {
 	await run(applyManagedDaemonEnv)
 	await import("./server.js")
@@ -56,6 +67,7 @@ case "-h": {
 	motel daemon
 	motel status
 	motel stop
+	motel restart
 	motel server
 	motel mcp
 	motel services