How awizemann/harness works
Harness is a native macOS user-testing tool: a developer configures an app, goal, and persona; Harness launches or builds the target, an AI agent observes and acts across iOS Simulator, macOS, or Web, and the run produces an outcome, replayable action history, and friction report. The GUI and CLI support autonomous runs; the standalone MCP server also exposes autonomous runs and direct, step-level UI sessions. The graph follows README-described capabilities and sampled composition/orchestration seams; several feature implementations are unsampled, so their internal call relationships are omitted.
Main entry points: RunCoordinator.swift Run coordinator · PlatformAdapter.swift Platform adapter · HarnessApp.swift Harness GUI · ToolHandlers.swift MCP tool handlers
Components 27
Setup and authoring
- Harness GUI
Harness/App/HarnessApp.swift - App and settings
Harness/Features/Applications - Goal and persona
Harness/Features/GoalInput - Actions and chains
Harness/Features/Actions
Run runtime
- Dependency container
Harness/App/AppContainer.swift - Run coordinator
Harness/Domain/RunCoordinator.swift - Agent loop
Harness/Domain/AgentLoop.swift - Agent tools
Harness/Tools/AgentTools.swift - Model client factory
Harness/Services/LLMClientFactory.swift - LLM providers
Harness/Services
Target platforms
- Platform adapter
Harness/Platforms/PlatformAdapter.swift - iOS Simulator driver
Harness/Platforms/iOS/IOSPlatformAdapter.swift - WebDriverAgent client
Harness/Services/WDAClient.swift - macOS app driver
Harness/Platforms/MacOS/MacOSPlatformAdapter.swift - Web app driver
Harness/Platforms/Web/WebPlatformAdapter.swift - Direct UI sessions
Harness/UISessions/UISessionSupervisor.swift
Run artifacts
- Run history
Harness/Services/RunHistoryStore.swift - Run logs
Harness/Services/RunLogger.swift - Run replay
Harness/Features/RunReplay - Friction reports
Harness/Features/FrictionReport
External interfaces
- MCP server
HarnessMCP/MCPServer.swift - MCP tool handlers
HarnessMCP/ToolHandlers.swift - CLI runner
HarnessCLI/HarnessRunner.swift
Other components
- Developer
- External agent
- Test target
- Model service
Connections 30
- Developer → Harness GUI: configures and starts
README.md - Harness GUI → App and settings: manages targets
- Harness GUI → Goal and persona: submits goal
- Harness GUI → Dependency container: uses composition root
Harness/App/AppContainer.swift - Dependency container → Run coordinator: constructs per-run
Harness/App/AppContainer.swift - Run coordinator → Agent loop: orchestrates
Harness/Domain/RunCoordinator.swift - Run coordinator → Platform adapter: prepares and drives
Harness/Domain/RunCoordinator.swift - Agent loop → Agent tools: issues tool calls
- Dependency container → Model client factory: selects client
Harness/App/AppContainer.swift - Model client factory → LLM providers: creates provider client
Harness/Services/LLMClientFactory.swift - LLM providers → Model service: requests decisions
- Platform adapter → iOS Simulator driver: dispatches by platform
Harness/Platforms/PlatformAdapter.swift - Platform adapter → macOS app driver: dispatches by platform
Harness/Platforms/PlatformAdapter.swift - Platform adapter → Web app driver: dispatches by platform
Harness/Platforms/PlatformAdapter.swift - iOS Simulator driver → WebDriverAgent client: uses WDA
- iOS Simulator driver → Test target: drives simulator target
README.md - macOS app driver → Test target: drives macOS target
README.md - Web app driver → Test target: drives WebKit target
README.md - Run coordinator → Run history: persists run records
Harness/Domain/RunCoordinator.swift - Run coordinator → Run logs: appends run events
Harness/Domain/RunCoordinator.swift - Run history → Run replay: supplies run history
- Run history → Friction reports: supplies run findings
- External agent → MCP server: sends MCP requests
README.md - MCP server → MCP tool handlers: dispatches tools
HarnessMCP/MCPServer.swift - MCP tool handlers → Run history: reads and updates
HarnessMCP/ToolHandlers.swift - MCP tool handlers → Run coordinator: starts autonomous runs
HarnessMCP/ToolHandlers.swift - MCP tool handlers → Direct UI sessions: starts UI sessions
- Direct UI sessions → Platform adapter: prepares platform
Harness/UISessions/UISessionSupervisor.swift - Developer → CLI runner: starts dev runs
README.md - CLI runner → Run coordinator: runs coordinator
HarnessCLI/HarnessRunner.swift