Settings and demo projects
Open Tracebeam → Settings (⌘,). Settings use a category sidebar; Proxy configuration is here too, not in a separate setup modal.
| Category | What it controls |
|---|---|
| General | Default JSON view and demo projects |
| Appearance | Automatic, Light, or Dark |
| Connections | Basic/Secure, network access, listener port, key and Device CA |
| Capture | Live memory budget, disk history, body limits, binary response capture |
| Recording | Writer buffer |
| Proxy | Listener, port, network access, Proxy CA, device setup |
| OpenAPI | Shared API library and automatic contract checks |
| AI Agents | Opt-in local agent access and permissions |
| Diagnostics | Capture/performance counters and optional crash reports |
| Developer | Fixed main-window dimensions for screenshots |
Port, capture-budget/body-limit, and recording-buffer changes use their page’s Apply Changes. Restore Section Defaults changes only that page’s draft. Appearance, connection mode/network access, inspector preferences, and automatic contract checking apply immediately; connection changes can disconnect devices and clear live capture. Opening Settings does not enable the proxy or change certificate trust.
Appearance
Section titled “Appearance”Automatic follows macOS, including later system appearance changes. Light and Dark override it for Tracebeam windows. The choice is remembered across launches.
Demo projects
Section titled “Demo projects”Under General → Demo Projects, choose which example opens first and press Start Demo:
- Atlas Demo: React Native, including Redux, Zustand, MMKV, TanStack Query, and navigation.
- Cetina Demo: Flutter, including Provider, Shared Preferences, Secure Storage, and Go Router.
Each project has its own sample device, 25 requests, 20 logs, state, actions, snapshots, and a linked Demo Shop API with intentional request/response violations. Use Projects above the sidebar navigation to switch; the normal device picker and project-scoped views still apply.
Try project names, icons, colors, reordering, deletion confirmation, device assignments, saved views, and sidebar/inspector preferences. Demo changes stay in memory and reset after leaving Demo Mode. Real projects, credentials, selected devices, recordings, and proxy rules remain unchanged.
State/API examples are read-only. Real request sending, recording, and Proxy are not simulated. Stop from Settings or Exit Demo Mode in the device picker. Opening a real recording also exits demo mode.
Developer screenshot size
Section titled “Developer screenshot size”Developer → Keep a fixed window size locks the main window to saved dimensions, including its title bar. The default is 1440 × 900 (16:10), pre-filled in editable Width and Height fields. Choose Apply Size, or Save Size while disabled; Use Default Size restores the dimensions without changing whether the lock is enabled.
The setting applies now and on future launches. Disable it to restore normal resizing. Settings and other windows are not resized.
Dimensions are macOS points, not image pixels. On a 2× Retina display, 1440 × 900 points produces 2880 × 1800 pixels before screenshot-tool margins/shadows. Oversized dimensions fit the display’s usable space where possible, subject to the app’s minimum layout. Use the same display scale and leave full screen for repeatable screenshots.
Memory and Capture Health
Section titled “Memory and Capture Health”Capture → Live Capture Memory offers a shared budget for live SDK data, proxy traffic, and retained disconnected sessions. Reducing it trims older data. This is not a total process-memory cap: UI, replay, request tabs, and recording have their own costs and limits.
Pausing a Network, Console, or Timeline list freezes its presentation—not capture. Arrival counts and Resume Live help you catch up; paused rows can still expire under retention limits.
The toolbar’s Capture Health panel reports dropped/rejected messages, evictions, history-write errors, recording interruptions, and connection problems. App-wide counters are labeled separately from selected-device body truncation/omission. No warning-free state guarantees complete capture. SDK-local drop counters are not yet forwarded to this panel.
Optional crash reports
Section titled “Optional crash reports”Diagnostics → Crash Reports → Keep crash reports on this Mac is off by default and requires consent. It stores filtered technical summaries delivered by macOS—not captured traffic, console text, state, or a third-party analytics feed. Delivery may be delayed or unavailable; a force quit does not necessarily produce a report.
Use Review… to see the exact summary. Explicit review confirmation enables Copy, Export, and Share; nothing is automatically uploaded. An optional description may contain private data, so review it too. Import macOS Report… accepts a supported Tracebeam crash report without enabling ongoing collection.
Stored summaries are local plaintext, limited to 10 reports with 30-day retention. Deleting them requires confirmation and does not delete macOS originals or exported copies. Disabling collection retains existing reports for review/deletion.
Local AI agents
Section titled “Local AI agents”AI-agent access is opt-in, local, and read-only. Enable only the permissions you need under AI Agents and inspect its configuration/audit information there. It starts disabled on launch; opening Settings alone does not enable it.