envoy
Spawn Claude Code agents that operate inside any local or remote project directory. Each agent runs as its own Claude CLI instance rooted in
Open source Repository Open in the app JSON README (API)
About
Spawn Claude Code agents that operate inside any local or remote project directory. Each agent runs as its own Claude CLI instance rooted in the target folder, with full access to that project's codebase and context. Supports parallel dispatch across multiple projects, SSH remote execution, model selection, and configurable timeouts.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- michaelslain
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-04-08T11:34:12Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
michaelslain/claude-envoy/envoy
README
# claude-envoy
MCP server that dispatches Claude Code agents to any local or remote directory
## Install
```bash
git clone https://github.com/michaelslain/claude-envoy.git
claude --plugin-dir /path/to/claude-envoy
```
## Usage
The `envoy` tool dispatches a Claude Code agent into a directory with a prompt and returns its output.
| Parameter | Type | Required | Description |
|-------------|--------|----------|-------------|
| `directory` | string | yes | Absolute path to run the agent in |
| `prompt` | string | yes | Task to give the spawned agent |
| `host` | string | no | SSH host for remote dispatch (e.g. `user@host`) |
| `model` | string | no | Model override: `opus`, `sonnet`, `haiku` |
| `effort` | string | no | Thinking effort: `low`, `medium`, `high` |
| `timeout` | number | no | Timeout in seconds (default: 300) |
## Examples
### Local dispatch
```
envoy({
directory: "/Users/me/my-project",
prompt: "Run the tests and fix any failures"
})
```
### Remote SSH dispatch
```
envoy({
directory: "/home/user/api",
host: "user@prod-server",
prompt: "Check the logs for errors in the last hour"
})
```
### Parallel dispatch
```
envoy({ directory: "/Users/me/frontend", prompt: "Add dark mode support" })
envoy({ directory: "/Users/me/backend", prompt: "Add the /theme endpoint" })
```
### Using different models
```
envoy({
directory: "/Users/me/project",
prompt: "Refactor the auth module",
model: "opus",
effort: "high"
})
```
## Requirements
- [Bun](https://bun.sh) runtime
- [Claude CLI](https://claude.ai/download) installed and authenticated
- SSH access to the target host (for remote dispatch), with Claude CLI installed there
## Development
```bash
git clone https://github.com/michaelslain/claude-envoy.git
cd claude-envoy
bun install
```
Test locally:
```bash
claude --plugin-dir .
```
Run the MCP server directly:
```bash
bun server.ts
```
Watch mode:
```bash
bun --watch server.ts
```
## License
MIT