opencode-bifrost 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 itsmylife44
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# Bifrost
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
+[![Bun](https://img.shields.io/badge/Bun-1.x-orange.svg)](https://bun.sh/)
+
+Persistent SSH connection plugin for [OpenCode](https://github.com/opencode-ai/opencode).
+
+Bifrost maintains a single SSH connection using ControlMaster multiplexing, so every command reuses the same connection instead of reconnecting each time.
+
+![Bifrost Demo](assets/demo.gif)
+
+## Installation
+
+### 1. Register the plugin
+
+Add to your `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "plugins": [
+    "github:itsmylife44/bifrost"
+  ]
+}
+```
+
+### 2. Create the SSH config
+
+Create `~/.config/opencode/bifrost.json`:
+
+```json
+{
+  "host": "your-server-ip",
+  "user": "root",
+  "keyPath": "~/.ssh/id_rsa"
+}
+```
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `host` | Yes | - | Server IP or hostname |
+| `user` | No | `root` | SSH username |
+| `keyPath` | Yes | - | Path to SSH private key |
+| `port` | No | `22` | SSH port |
+
+> **Note:** Password authentication is not supported. Use SSH keys only.
+
+### 3. Restart OpenCode
+
+The plugin is installed automatically on startup.
+
+## Usage
+
+Once configured, the agent automatically uses Bifrost when you mention:
+- "server", "remote", "deploy", "production", "staging"
+- "check the server", "run on server", "server logs"
+
+### Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `bifrost_connect` | Establish SSH connection (called automatically) |
+| `bifrost_exec` | Run a command on the server |
+| `bifrost_status` | Check connection status |
+| `bifrost_disconnect` | Close the connection |
+| `bifrost_upload` | Upload a file to the server |
+| `bifrost_download` | Download a file from the server |
+
+### Example Prompts
+
+```
+"How's the server doing?"
+"Show me the nginx logs"
+"Restart the docker containers"
+"Upload config.yaml to /etc/app/"
+"What's using port 8080?"
+```
+
+## How It Works
+
+Bifrost uses SSH ControlMaster to maintain a persistent connection:
+
+```
+First command:  [Connect] -----> [Execute] -----> [Keep socket open]
+Next commands:  [Reuse socket] -> [Execute] -----> [Still open]
+Session ends:   [Auto-disconnect]
+```
+
+The control socket is stored at `~/.ssh/bifrost-control/`.
+
+## Security
+
+All inputs are validated before execution to prevent injection attacks:
+
+- **Path traversal** (`../`) blocked
+- **Command injection** (`;`, `|`, `&`, `` ` ``, `$()`) blocked
+- **Shell expansion** (`*`, `?`, `~`, `{}`) blocked
+- **Unicode bypass attempts** detected and rejected
+- **Null bytes** and control characters rejected
+
+## Requirements
+
+- OpenCode with plugin support
+- SSH key-based authentication
+
+## Development
+
+```bash
+# Run tests
+bun test
+
+# Type check
+bun run typecheck
+
+# Build
+bun run build
+```
+
+## License
+
+MIT

package/bun.lock

@@ -0,0 +1,34 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "bifrost",
+      "dependencies": {
+        "@opencode-ai/plugin": "^1.1.53",
+        "zod": "^4.3.6",
+      },
+      "devDependencies": {
+        "bun-types": "latest",
+        "typescript": "^5.9.3",
+      },
+    },
+  },
+  "packages": {
+    "@opencode-ai/plugin": ["@opencode-ai/plugin@1.1.53", "", { "dependencies": { "@opencode-ai/sdk": "1.1.53", "zod": "4.1.8" } }, "sha512-9ye7Wz2kESgt02AUDaMea4hXxj6XhWwKAG8NwFhrw09Ux54bGaMJFt1eIS8QQGIMaD+Lp11X4QdyEg96etEBJw=="],
+
+    "@opencode-ai/sdk": ["@opencode-ai/sdk@1.1.53", "", {}, "sha512-RUIVnPOP1CyyU32FrOOYuE7Ge51lOBuhaFp2NSX98ncApT7ffoNetmwzqrhOiJQgZB1KrbCHLYOCK6AZfacxag=="],
+
+    "@types/node": ["@types/node@25.2.2", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-BkmoP5/FhRYek5izySdkOneRyXYN35I860MFAGupTdebyE66uZaR+bXLHq8k4DirE5DwQi3NuhvRU1jqTVwUrQ=="],
+
+    "bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "zod": ["zod@4.3.6", "", {}, "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg=="],
+
+    "@opencode-ai/plugin/zod": ["zod@4.1.8", "", {}, "sha512-5R1P+WwQqmmMIEACyzSvo4JXHY5WiAFHRMg+zBZKgKS+Q1viRa0C1hmUKtHltoIFKtIdki3pRxkmpP74jnNYHQ=="],
+  }
+}

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+export declare const BifrostConfigSchema: z.ZodObject<{
+    host: z.ZodString;
+    user: z.ZodDefault<z.ZodString>;
+    keyPath: z.ZodString;
+    port: z.ZodDefault<z.ZodNumber>;
+    connectTimeout: z.ZodDefault<z.ZodNumber>;
+    controlPersist: z.ZodDefault<z.ZodString>;
+    serverAliveInterval: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type BifrostConfig = z.infer<typeof BifrostConfigSchema>;
+export declare function parseConfig(configPath: string): BifrostConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,mBAAmB;;;;;;;;iBA2C9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AA8ChE,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAoD7D"}

package/dist/hooks.d.ts

@@ -0,0 +1,2 @@
+export declare const placeholder = true;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const Bifrost: Plugin;
+export default Bifrost;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AASlD,QAAA,MAAM,OAAO,EAAE,MAoDd,CAAC;AAEF,eAAe,OAAO,CAAC"}