ada capture — Start a Capture Session

The ada capture command starts a new capture session, launching your app with full tracing enabled.

Usage

ada capture start <binary_path>

What It Does

  1. Launches the target binary with dynamic instrumentation attached
  2. Begins recording three tracks simultaneously:
    • Screen — captures the display
    • Voice — records microphone input
    • Function Traces — instruments function calls with sub-microsecond precision
  3. Creates a session bundle directory with all captured data

Session Output

When capture completes, a session directory is created containing:

session-<id>/
├── screen/          # Screen recording frames
├── audio/           # Voice recording
├── traces/          # Function call traces
└── metadata.json    # Session metadata

Environment Setup

Before running, set the library search path:

export ADA_AGENT_RPATH_SEARCH_PATHS="${ADA_LIB_DIR}"

Notes

  • Capture runs as a background process — your app runs normally in the foreground
  • Capture stops automatically when the target app quits
  • The capture and query processes run in separate lanes — zero interference with your app