axterminator 0.10.1

macOS GUI testing framework with background testing, sub-millisecond element access, and self-healing locators
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# Virtual Desktops (Spaces)

AXTerminator can manage macOS virtual desktops via the `spaces` feature flag.

## Enable Spaces

Build with the `spaces` feature:

```bash
cargo build --release --features "cli,spaces"
```

!!! warning "Private API"
    The spaces feature uses Apple's `CGSSpace` private SPI. It is tested on macOS 14+ but is incompatible with App Store distribution.

## MCP Tools

| Tool | Description |
|------|-------------|
| `ax_list_spaces` | List all virtual desktops |
| `ax_create_space` | Create a new virtual desktop |
| `ax_move_to_space` | Move a window to a specific space |
| `ax_switch_space` | Switch to a specific space |
| `ax_destroy_space` | Destroy a virtual desktop |

## Use Cases

### Test Isolation

Run tests on a dedicated virtual desktop so they do not interfere with your work:

```bash
# Create isolated test space
axterminator create-space "Test Environment"

# Move test target to that space
axterminator move-to-space "Calculator" --space "Test Environment"

# Run tests
axterminator switch-space "Test Environment"
# ... run tests ...

# Clean up
axterminator destroy-space "Test Environment"
```

### Multi-Environment Testing

Test the same app in different configurations by isolating each instance on its own space.

## Limitations

- Requires macOS 14+ (tested)
- Uses private API -- not available for App Store apps
- Space creation/destruction may trigger Mission Control animations