executor 1.5.22 → 2.0.0-darwin-arm64

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Binary file
package/bin/executor CHANGED
Binary file
Binary file
Binary file
package/package.json CHANGED
@@ -1,14 +1,12 @@
1
1
  {
2
2
  "name": "executor",
3
- "version": "1.5.22",
4
- "description": "Local AI executor with a CLI, local API server, and web UI.",
5
- "keywords": [
6
- "agent",
7
- "ai",
8
- "automation",
9
- "cli",
10
- "executor",
11
- "local-first"
3
+ "version": "2.0.0-darwin-arm64",
4
+ "description": "Local AI executor with a CLI, local API server, and web UI. (darwin-arm64)",
5
+ "os": [
6
+ "darwin"
7
+ ],
8
+ "cpu": [
9
+ "arm64"
12
10
  ],
13
11
  "homepage": "https://github.com/RhysSullivan/executor",
14
12
  "bugs": {
@@ -18,21 +16,5 @@
18
16
  "type": "git",
19
17
  "url": "git+https://github.com/RhysSullivan/executor.git"
20
18
  },
21
- "license": "MIT",
22
- "bin": {
23
- "executor": "bin/executor"
24
- },
25
- "optionalDependencies": {
26
- "executor-linux-x64": "npm:executor@1.5.22-linux-x64",
27
- "executor-linux-arm64": "npm:executor@1.5.22-linux-arm64",
28
- "executor-linux-x64-musl": "npm:executor@1.5.22-linux-x64-musl",
29
- "executor-linux-arm64-musl": "npm:executor@1.5.22-linux-arm64-musl",
30
- "executor-darwin-x64": "npm:executor@1.5.22-darwin-x64",
31
- "executor-darwin-arm64": "npm:executor@1.5.22-darwin-arm64",
32
- "executor-windows-x64": "npm:executor@1.5.22-windows-x64",
33
- "executor-windows-arm64": "npm:executor@1.5.22-windows-arm64"
34
- },
35
- "engines": {
36
- "node": ">=20"
37
- }
19
+ "license": "MIT"
38
20
  }
package/README.md DELETED
@@ -1,184 +0,0 @@
1
- # executor
2
-
3
- [https://github.com/user-attachments/assets/11225f83-e848-42ba-99b2-a993bcc88dad](https://github.com/user-attachments/assets/11225f83-e848-42ba-99b2-a993bcc88dad)
4
-
5
- The integration layer for AI agents. One catalog for every tool, shared across every agent you use.
6
-
7
- [Ask DeepWiki](https://deepwiki.com/RhysSullivan/executor)
8
-
9
- ## Quick start
10
-
11
- ```bash
12
- npm install -g executor
13
- executor install
14
- executor web
15
- ```
16
-
17
- This installs the local background service and opens the web UI. From there, add your first source and start using tools.
18
-
19
- ### Use as an MCP server
20
-
21
- Point any MCP-compatible agent (Cursor, Claude Code, OpenCode, etc.) at Executor to share your tool catalog, auth, and policies across all of them.
22
-
23
- ```bash
24
-
25
- executor mcp
26
- ```
27
-
28
- Example `mcp.json` for Claude Code / Cursor:
29
-
30
- ```json
31
- {
32
- "mcpServers": {
33
- "executor": {
34
- "command": "executor",
35
- "args": ["mcp"]
36
- }
37
- }
38
- }
39
- ```
40
-
41
- ### Use with Pi
42
-
43
- [Pi](https://pi.dev) does not include a built-in MCP client. To use Executor from Pi, install the community bridge:
44
-
45
- ```bash
46
- pi install git:github.com/gvkhosla/pi-executor-mcp@v0.2.0
47
- ```
48
-
49
- Reload Pi, then verify the bridge:
50
-
51
- ```text
52
- /reload
53
- /executor-status
54
- ```
55
-
56
- After that, ask Pi to search, inspect, and call tools through Executor.
57
-
58
- ## Add a source
59
-
60
- If you can represent it with a JSON schema, it can be an integration. Executor has first-party support for OpenAPI, GraphQL, MCP, and Google Discovery — but the plugin system is open to any source type.
61
-
62
- ### Via the web UI
63
-
64
- Run `executor web`, go to **Add Source**, paste a URL, and Executor will detect the type, index the tools, and handle auth.
65
-
66
- ### Via the CLI
67
-
68
- ```bash
69
- executor call executor openapi addSource '{
70
- "spec": "https://petstore3.swagger.io/api/v3/openapi.json",
71
- "namespace": "petstore",
72
- "baseUrl": "https://petstore3.swagger.io/api/v3"
73
- }'
74
- ```
75
-
76
- Use `baseUrl` when the OpenAPI document has relative `servers` entries (for example `"/api/v3"`).
77
-
78
- ## Use tools
79
-
80
- Agents discover and call tools through a typed TypeScript runtime:
81
-
82
- ```ts
83
- // discover by intent
84
- const matches = await tools.discover({ query: "github issues", limit: 5 });
85
-
86
- // inspect the schema
87
- const detail = await tools.describe.tool({
88
- path: matches.bestPath,
89
- includeSchemas: true,
90
- });
91
-
92
- // call with type safety
93
- const issues = await tools.github.issues.list({
94
- owner: "vercel",
95
- repo: "next.js",
96
- });
97
- ```
98
-
99
- Use tools via the CLI:
100
-
101
- ```bash
102
- executor tools search "send email"
103
- executor call --help
104
- executor call github --help
105
- executor call github issues --help
106
- executor call cloudflare --help --match dns --limit 20
107
- executor call github issues create '{"owner":"octocat","repo":"Hello-World","title":"Hi"}'
108
- executor call gmail send '{"to":"alice@example.com","subject":"Hi"}'
109
- ```
110
-
111
- `executor call`, `executor resume`, and `executor tools ...` commands auto-start a local daemon if needed.
112
- If the default port is busy, the CLI will pick an available local port and track it automatically.
113
-
114
- If an execution pauses for auth or approval, resume it:
115
-
116
- ```bash
117
- executor resume --execution-id exec_123
118
- ```
119
-
120
- ## CLI reference
121
-
122
- ```bash
123
- executor install # install/start the durable background service
124
- executor web # open the running web UI
125
- executor web --foreground # start a temporary foreground runtime + web UI
126
- executor daemon run # start persistent local daemon in background
127
- executor daemon status # show daemon status
128
- executor daemon stop # stop daemon
129
- executor daemon restart # restart daemon
130
- executor mcp # start MCP endpoint
131
- executor call <path...> '{"k":"v"}' # invoke a tool by path segments
132
- executor call <path...> --help # browse namespaces/resources/methods
133
- executor call <path...> --help --match "<text>" --limit <n> # narrow huge namespaces
134
- executor resume --execution-id <id> # resume paused execution
135
- executor tools search "<query>" # search tools by intent
136
- executor tools sources # list configured sources + tool counts
137
- executor tools describe <path> # show tool TypeScript/JSON schema
138
- ```
139
-
140
- ## Developing locally
141
-
142
- ```bash
143
- bun install
144
- bun dev
145
- ```
146
-
147
- The dev server starts at `http://127.0.0.1:4788`.
148
-
149
- ### Tests
150
-
151
- ```bash
152
- bun run test # unit + integration suites
153
- bun run test:e2e # full-stack e2e: boots the cloud and self-host apps and drives them
154
- ```
155
-
156
- The browser e2e scenarios need Playwright's Chromium once per machine:
157
- `bunx playwright install chromium`.
158
-
159
- ## Community
160
-
161
- Join the Discord: [https://discord.gg/eF29HBHwM6](https://discord.gg/eF29HBHwM6)
162
-
163
- ## Learn more
164
-
165
- Visit [executor.sh](https://executor.sh) to learn more.
166
-
167
- ## Attribution
168
-
169
- - Thank you to [Crystian](https://www.linkedin.com/in/crystian/) for providing the npm package name `executor`.
170
-
171
- ## References
172
-
173
- As part of my coding process, I give my agent access to references to other codebases to understand patterns and how other people have implemented systems.
174
-
175
- A non exhaustive list of references are:
176
-
177
- - [Better Auth](https://github.com/better-auth/better-auth) - Storage adapter reference
178
- - [Effect](https://github.com/Effect-TS/effect) - General code patterns
179
- - [OpenCode](https://github.com/anomalyco/opencode) - Plugin system reference
180
- - [OpenClaw](https://github.com/openclaw/openclaw) - Plugin system reference
181
- - [Emdash](https://github.com/emdash-cms/emdash) - Plugin system reference
182
- - [Pi](https://github.com/badlogic/pi-mono) - Plugin system reference
183
-
184
- It's encouraged also that you can use this codebase as a reference to understand how it's implemented