Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ Notable changes to Desktop Tools, newest first. Each release's GitHub release no

## [Unreleased]

## [0.14.0] - 2026-10-17

### Added

- The Desktop Tools app asks once per agent, such as Claude Code or a terminal app, "Allow *name* to control this Mac?", and refuses every request from an agent you haven't allowed with `CALLER_NOT_APPROVED`, listings and captures included, without making it wait. Agents are recognized by their validated signature, or by their path when unsigned, and **Approved Agents** in the menu revokes, allows or forgets each one. After updating, each agent you use is asked about once. Recent Activity names the agent, such as `claude-code`, instead of `node`. Embedding apps opt in with `desktop_tools_set_caller_handler`. ([#120](https://github.com/githubnext/desktop-tools/pull/120))
Expand Down Expand Up @@ -189,7 +191,8 @@ Notable changes to Desktop Tools, newest first. Each release's GitHub release no

- The first release: a signed, notarized Desktop Tools menu bar app, and the desktop tools served over MCP. ([#28](https://github.com/githubnext/desktop-tools/pull/28), [#29](https://github.com/githubnext/desktop-tools/pull/29), [#12](https://github.com/githubnext/desktop-tools/pull/12))

[Unreleased]: https://github.com/githubnext/desktop-tools/compare/v0.13.1...HEAD
[Unreleased]: https://github.com/githubnext/desktop-tools/compare/v0.14.0...HEAD
[0.14.0]: https://github.com/githubnext/desktop-tools/compare/v0.13.1...v0.14.0
[0.13.1]: https://github.com/githubnext/desktop-tools/compare/v0.13.0...v0.13.1
[0.13.0]: https://github.com/githubnext/desktop-tools/compare/v0.12.0...v0.13.0
[0.12.0]: https://github.com/githubnext/desktop-tools/compare/v0.11.0...v0.12.0
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,15 +16,15 @@ You need macOS 15 or later and Node 22 or later. The MCP server runs from this r
Claude Code:

```sh
claude mcp add desktop -- npx -y --package=github:githubnext/desktop-tools#v0.13.1 desktop-tools-mcp
claude mcp add desktop -- npx -y --package=github:githubnext/desktop-tools#v0.14.0 desktop-tools-mcp
```

Codex, in `~/.codex/config.toml`:

```toml
[mcp_servers.desktop]
command = "npx"
args = ["-y", "--package=github:githubnext/desktop-tools#v0.13.1", "desktop-tools-mcp"]
args = ["-y", "--package=github:githubnext/desktop-tools#v0.14.0", "desktop-tools-mcp"]
```

Other MCP clients that start stdio servers from JSON, such as Cursor or Claude Desktop:
Expand All @@ -34,7 +34,7 @@ You need macOS 15 or later and Node 22 or later. The MCP server runs from this r
"mcpServers": {
"desktop": {
"command": "npx",
"args": ["-y", "--package=github:githubnext/desktop-tools#v0.13.1", "desktop-tools-mcp"]
"args": ["-y", "--package=github:githubnext/desktop-tools#v0.14.0", "desktop-tools-mcp"]
}
}
}
Expand Down
4 changes: 2 additions & 2 deletions docs/mcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
`desktop-tools-mcp` (`dist/mcp.js`) serves the desktop tools over stdio MCP, with Ace's native-first guidance as its instructions. By default it uses the [Desktop Tools app](app.md)'s signed client and socket in `~/.local/state/desktop-tools`. Run it from this repository with `npx`, pinned to a release tag, or from a checkout with `node`:

```sh
claude mcp add desktop -- npx -y --package=github:githubnext/desktop-tools#v0.13.1 desktop-tools-mcp
claude mcp add desktop -- npx -y --package=github:githubnext/desktop-tools#v0.14.0 desktop-tools-mcp
claude mcp add desktop -- node <path>/dist/mcp.js
```

Expand All @@ -23,7 +23,7 @@ For Codex, in `~/.codex/config.toml`:
```toml
[mcp_servers.desktop]
command = "npx"
args = ["-y", "--package=github:githubnext/desktop-tools#v0.13.1", "desktop-tools-mcp"]
args = ["-y", "--package=github:githubnext/desktop-tools#v0.14.0", "desktop-tools-mcp"]
```

The tool names, descriptions, and argument schemas come from `@githubnext/desktop-tools/tools` (`desktopTools`, `desktopRequest`), which Ace's `desktop_*` tools also use. [Tools](tools.md) lists them. The descriptions don't repeat the rules every tool shares: exact targets, single-use snapshots, background and foreground input, what each outcome means, pausing, `desktop_wait` and `expect`, and the recipes. `desktopToolRules(app)` returns those rules, and the server adds them to its instructions; a host with its own agent guidance should include them too.
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@githubnext/desktop-tools",
"version": "0.13.1",
"version": "0.14.0",
"description": "Signed macOS desktop inspection and input for agents, built on a pinned, patched Peekaboo Bridge",
"license": "MIT",
"type": "module",
Expand Down
Loading