splashshell 0.1.0 → 0.2.0
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.
- package/README.md +15 -46
- package/dist/splash.exe +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -14,58 +14,16 @@ A universal MCP server that exposes any shell (bash, pwsh, powershell, cmd) as a
|
|
|
14
14
|
- **Auto cwd handoff.** When a same-shell console is busy, a new one is auto-started in the source console's directory and your command runs immediately — no manual `cd` needed.
|
|
15
15
|
- **Sub-agent isolation.** Allocate per-agent consoles with `is_subagent` + `agent_id` so parallel agents don't clobber each other's shells.
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
```mermaid
|
|
20
|
-
graph TB
|
|
21
|
-
Client["MCP Client<br/>(Claude Code, etc.)"]
|
|
22
|
-
|
|
23
|
-
subgraph Proxy["splashshell proxy (stdio MCP server)"]
|
|
24
|
-
CM["Console Manager<br/>(cwd tracking, re-claim,<br/>cache drain, switching)"]
|
|
25
|
-
Tools["start_console<br/>execute_command<br/>wait_for_completion<br/>read_file / write_file / edit_file<br/>search_files / find_files"]
|
|
26
|
-
end
|
|
27
|
-
|
|
28
|
-
subgraph Consoles["Visible Console Windows (each runs splash --console)"]
|
|
29
|
-
subgraph C1["#9876 Sapphire (bash)"]
|
|
30
|
-
PTY1["ConPTY + bash<br/>(+ OSC 633)"]
|
|
31
|
-
end
|
|
32
|
-
subgraph C2["#5432 Cobalt (pwsh)"]
|
|
33
|
-
PTY2["ConPTY + pwsh<br/>(+ OSC 633)"]
|
|
34
|
-
end
|
|
35
|
-
subgraph C3["#1234 Topaz (cmd)"]
|
|
36
|
-
PTY3["ConPTY + cmd.exe<br/>(+ OSC 633 via PROMPT)"]
|
|
37
|
-
end
|
|
38
|
-
end
|
|
39
|
-
|
|
40
|
-
User["User"] -- "keyboard" --> C1
|
|
41
|
-
User -- "keyboard" --> C2
|
|
42
|
-
User -- "keyboard" --> C3
|
|
43
|
-
Client -- "stdio" --> Proxy
|
|
44
|
-
CM -- "Named Pipe" --> C1
|
|
45
|
-
CM -- "Named Pipe" --> C2
|
|
46
|
-
CM -- "Named Pipe" --> C3
|
|
47
|
-
CM -. "auto-switch<br/>if busy" .-> C1
|
|
48
|
-
CM -. "shell routing" .-> C2
|
|
49
|
-
```
|
|
17
|
+
> **Architecture diagram**: see the [GitHub README](https://github.com/yotsuda/splashshell#architecture) for a mermaid diagram of the proxy/worker/console layout.
|
|
50
18
|
|
|
51
19
|
## Install
|
|
52
20
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
```bash
|
|
56
|
-
git clone https://github.com/yotsuda/splashshell.git
|
|
57
|
-
cd splashshell
|
|
58
|
-
dotnet publish -c Release -r win-x64 --no-self-contained -o ./dist
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
The binary is `./dist/splash.exe`.
|
|
62
|
-
|
|
63
|
-
## MCP Setup
|
|
21
|
+
No global install is required — `npx` fetches and runs splashshell on demand. The only prerequisite is the [.NET 9 Desktop Runtime](https://dotnet.microsoft.com/download/dotnet/9.0) (the package bundles a ~5.6 MB native `splash.exe` that needs it).
|
|
64
22
|
|
|
65
23
|
### Claude Code
|
|
66
24
|
|
|
67
25
|
```bash
|
|
68
|
-
claude mcp add splash -s user
|
|
26
|
+
claude mcp add-json splash -s user '{"command":"npx","args":["-y","splashshell"]}'
|
|
69
27
|
```
|
|
70
28
|
|
|
71
29
|
### Claude Desktop
|
|
@@ -76,12 +34,23 @@ Add to `%APPDATA%\Claude\claude_desktop_config.json`:
|
|
|
76
34
|
{
|
|
77
35
|
"mcpServers": {
|
|
78
36
|
"splash": {
|
|
79
|
-
"command": "
|
|
37
|
+
"command": "npx",
|
|
38
|
+
"args": ["-y", "splashshell"]
|
|
80
39
|
}
|
|
81
40
|
}
|
|
82
41
|
}
|
|
83
42
|
```
|
|
84
43
|
|
|
44
|
+
### Build from source (for development)
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
git clone https://github.com/yotsuda/splashshell.git
|
|
48
|
+
cd splashshell
|
|
49
|
+
dotnet publish -c Release -r win-x64 --no-self-contained -o ./dist
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
The binary is `./dist/splash.exe`. Use the absolute path instead of the `npx` command in your MCP config.
|
|
53
|
+
|
|
85
54
|
## Tools
|
|
86
55
|
|
|
87
56
|
### Shell tools
|
package/dist/splash.exe
CHANGED
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "splashshell",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Shared console MCP server for any shell (bash, pwsh, cmd) — AI and user work in the same terminal. Real-time command visibility, interactive prompt support, session persistence, multi-shell management with automatic cwd handoff.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Yoshifumi Tsuda",
|