An AI agent uses a real GNOME/Wayland desktop - pressing actual widgets, not guessing at pixels - optionally on an invisible second GNOME session, so your own screen stays yours.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add deskwright -- uvx deskwright~/.codex/config.toml
[mcp_servers.deskwright]
command = "uvx"
args = ["deskwright"]
# codex mcp add deskwright -- uvx deskwright~/.cursor/mcp.json
{
"mcpServers": {
"deskwright": {
"command": "uvx",
"args": [
"deskwright"
]
}
}
}.vscode/mcp.json
{
"servers": {
"deskwright": {
"type": "stdio",
"command": "uvx",
"args": [
"deskwright"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"deskwright": {
"command": "uvx",
"args": [
"deskwright"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"deskwright": {
"command": "uvx",
"args": [
"deskwright"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"deskwright": {
"command": "uvx",
"args": [
"deskwright"
]
}
}
}