idb-targets
Discover, inspect, focus, and manage connections to IDB targets for iOS simulators and devices.
Instructions
idb-targets
Unified IDB target management - discover, inspect, focus, and manage connections.
Overview
Single tool for IDB target discovery and connection management. Routes to specialized handlers while maintaining clean operation semantics.
Operations
list
List all available IDB targets.
Parameters:
state(string, optional): Filter by state - 'Booted' or 'Shutdown'type(string, optional): Filter by type - 'device' or 'simulator'
Example:
await idbTargetsToolUnified({
operation: 'list',
state: 'Booted'
})Returns: List of targets with metadata, state, and type information.
describe
Get detailed information about a specific target.
Parameters:
udid(string): Target UDID
Example:
await idbTargetsToolUnified({
operation: 'describe',
udid: 'ABC-123-DEF'
})Returns: Detailed target information including screen dimensions, device model, iOS version.
focus
Focus simulator window for interactive testing.
Parameters:
udid(string): Simulator UDID
Example:
await idbTargetsToolUnified({
operation: 'focus',
udid: 'ABC-123-DEF'
})connect
Establish IDB companion connection to target.
Parameters:
udid(string, optional): Target UDID - auto-detects if omitted
Example:
await idbTargetsToolUnified({
operation: 'connect',
udid: 'ABC-123-DEF'
})Notes: Establishes persistent gRPC connection for faster subsequent operations. Useful for warming up connections before automated testing.
disconnect
Close IDB companion connection to target.
Parameters:
udid(string, optional): Target UDID
Example:
await idbTargetsToolUnified({
operation: 'disconnect',
udid: 'ABC-123-DEF'
})Related Tools
idb-app: App management on IDB targetsidb-ui-tap,idb-ui-input,idb-ui-gesture: UI automation on targets
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | ||
| udid | No | ||
| state | No | ||
| type | No |