This repository was archived by the owner on Jun 27, 2026. It is now read-only.
BranchesTags

Latest commit

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
docs
docs
.gitattributes
.gitattributes
README.md
README.md
index.ts
index.ts
package.json
package.json
tsconfig.json
tsconfig.json
types.ts
types.ts

Repository files navigation

Binder Plugin SDK

The official SDK for building plugins for Binder — a developer-focused terminal IDE built with Go + React.

Plugins are installable at runtime through the in-app Plugin Store. They can add new tab types, contribute slash commands to the terminal, and interact with the host application through a sandboxed API.

Quick start

# Clone the plugin template
git clone https://github.com/BinderTools/plugin-template my-plugin
cd my-plugin
npm install
# Build a production bundle
npm run build
# → produces dist/index.js (the plugin bundle)

The Plugin Store fetches dist/index.js from your public GitHub repository's default branch.

How plugins work

  1. A plugin is a single JavaScript file (ESM bundle) that exports a Plugin object as its default export.
  2. When a user installs your plugin from the Plugin Store, Binder downloads dist/index.js from your GitHub repository and caches it locally.
  3. On next launch, the app dynamically loads the cached bundle and registers the plugin.
  4. If your plugin declares a tabType, Binder routes /your-command terminal commands and app:open-tab events with that type to your TabComponent.

Minimal plugin example

importReactfrom'react'importtype{Plugin,PluginTabProps}from'@binder/plugin-sdk'functionMyTab({ context }: PluginTabProps){const{ executeCommand, cwd }=contextreturn(<divstyle={{padding: 16,color: '#ccc'}}><p>Working directory: {cwd??'unknown'}</p><buttononClick={()=>executeCommand?.('ls -la')}>
List files
</button></div>)}constplugin: Plugin={id: 'my-plugin',name: 'My Plugin',description: 'A minimal example plugin.',author: 'your-github-handle',version: '1.0.0',tabType: 'my-plugin',tabTitle: 'my plugin',TabComponent: MyTab,}exportdefaultplugin

Repository structure

Your plugin repository must include:

my-plugin/
dist/
index.js ← compiled ESM bundle (required)
src/
index.tsx ← plugin source
package.json ← metadata (name, version, description, author, pluginId)
README.md

package.json fields

FieldDescription
nameDisplay name shown in the Plugin Store
versionSemver version string
descriptionShort description shown in the Plugin Store
authorAuthor name or GitHub handle
pluginIdUnique kebab-case ID (falls back to the repo name if omitted)

Build setup

Use any bundler that can output a single ESM file. Example with Vite:

// vite.config.tsimport{defineConfig}from'vite'importreactfrom'@vitejs/plugin-react'exportdefaultdefineConfig({plugins: [react()],build: {lib: {entry: 'src/index.tsx',formats: ['es'],fileName: ()=>'index.js',},rollupOptions: {// Bundle React — the host app's React is not exposed to plugins// external: ['react'],},outDir: 'dist',},})

Documentation

License

MIT

About

No description, website, or topics provided.

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content

This repository was archived by the owner on Jun 27, 2026. It is now read-only.

BranchesTags
Latest commit
History
5 Commits
Folders and files
NameName
Last commit message
Last commit date
docs
docs
.gitattributes
.gitattributes
README.md
README.md
index.ts
index.ts
package.json
package.json
tsconfig.json
tsconfig.json
types.ts
types.ts
Repository files navigation
Binder Plugin SDK
The official SDK for building plugins for Binder — a developer-focused terminal IDE built with Go + React.
Plugins are installable at runtime through the in-app Plugin Store. They can add new tab types, contribute slash commands to the terminal, and interact with the host application through a sandboxed API.
Quick start
# Clone the plugin template
git clone https://github.com/BinderTools/plugin-template my-plugin
cd my-plugin
npm install
# Build a production bundle
npm run build
# → produces dist/index.js (the plugin bundle)
The Plugin Store fetches dist/index.js from your public GitHub repository's default branch.
How plugins work
  1. A plugin is a single JavaScript file (ESM bundle) that exports a Plugin object as its default export.
  2. When a user installs your plugin from the Plugin Store, Binder downloads dist/index.js from your GitHub repository and caches it locally.
  3. On next launch, the app dynamically loads the cached bundle and registers the plugin.
  4. If your plugin declares a tabType, Binder routes /your-command terminal commands and app:open-tab events with that type to your TabComponent.
Minimal plugin example
importReactfrom'react'importtype{Plugin,PluginTabProps}from'@binder/plugin-sdk'functionMyTab({ context }: PluginTabProps){const{ executeCommand, cwd }=contextreturn(<divstyle={{padding: 16,color: '#ccc'}}><p>Working directory: {cwd??'unknown'}</p><buttononClick={()=>executeCommand?.('ls -la')}>
List files
</button></div>)}constplugin: Plugin={id: 'my-plugin',name: 'My Plugin',description: 'A minimal example plugin.',author: 'your-github-handle',version: '1.0.0',tabType: 'my-plugin',tabTitle: 'my plugin',TabComponent: MyTab,}exportdefaultplugin
Repository structure
Your plugin repository must include:
my-plugin/
dist/
index.js ← compiled ESM bundle (required)
src/
index.tsx ← plugin source
package.json ← metadata (name, version, description, author, pluginId)
README.md

package.json fields
FieldDescription
nameDisplay name shown in the Plugin Store
versionSemver version string
descriptionShort description shown in the Plugin Store
authorAuthor name or GitHub handle
pluginIdUnique kebab-case ID (falls back to the repo name if omitted)
Build setup
Use any bundler that can output a single ESM file. Example with Vite:
// vite.config.tsimport{defineConfig}from'vite'importreactfrom'@vitejs/plugin-react'exportdefaultdefineConfig({plugins: [react()],build: {lib: {entry: 'src/index.tsx',formats: ['es'],fileName: ()=>'index.js',},rollupOptions: {// Bundle React — the host app's React is not exposed to plugins// external: ['react'],},outDir: 'dist',},})
Documentation
License
MIT
About
No description, website, or topics provided.
Resources
Readme
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content

This repository was archived by the owner on Jun 27, 2026. It is now read-only.

BranchesTags
Latest commit
History
5 Commits
Folders and files
NameName
Last commit message
Last commit date
docs
docs
.gitattributes
.gitattributes
README.md
README.md
index.ts
index.ts
package.json
package.json
tsconfig.json
tsconfig.json
types.ts
types.ts
Repository files navigation
Binder Plugin SDK
The official SDK for building plugins for Binder — a developer-focused terminal IDE built with Go + React.
Plugins are installable at runtime through the in-app Plugin Store. They can add new tab types, contribute slash commands to the terminal, and interact with the host application through a sandboxed API.
Quick start
# Clone the plugin template
git clone https://github.com/BinderTools/plugin-template my-plugin
cd my-plugin
npm install
# Build a production bundle
npm run build
# → produces dist/index.js (the plugin bundle)
The Plugin Store fetches dist/index.js from your public GitHub repository's default branch.
How plugins work
  1. A plugin is a single JavaScript file (ESM bundle) that exports a Plugin object as its default export.
  2. When a user installs your plugin from the Plugin Store, Binder downloads dist/index.js from your GitHub repository and caches it locally.
  3. On next launch, the app dynamically loads the cached bundle and registers the plugin.
  4. If your plugin declares a tabType, Binder routes /your-command terminal commands and app:open-tab events with that type to your TabComponent.
Minimal plugin example
importReactfrom'react'importtype{Plugin,PluginTabProps}from'@binder/plugin-sdk'functionMyTab({ context }: PluginTabProps){const{ executeCommand, cwd }=contextreturn(<divstyle={{padding: 16,color: '#ccc'}}><p>Working directory: {cwd??'unknown'}</p><buttononClick={()=>executeCommand?.('ls -la')}>
List files
</button></div>)}constplugin: Plugin={id: 'my-plugin',name: 'My Plugin',description: 'A minimal example plugin.',author: 'your-github-handle',version: '1.0.0',tabType: 'my-plugin',tabTitle: 'my plugin',TabComponent: MyTab,}exportdefaultplugin
Repository structure
Your plugin repository must include:
my-plugin/
dist/
index.js ← compiled ESM bundle (required)
src/
index.tsx ← plugin source
package.json ← metadata (name, version, description, author, pluginId)
README.md

package.json fields
FieldDescription
nameDisplay name shown in the Plugin Store
versionSemver version string
descriptionShort description shown in the Plugin Store
authorAuthor name or GitHub handle
pluginIdUnique kebab-case ID (falls back to the repo name if omitted)
Build setup
Use any bundler that can output a single ESM file. Example with Vite:
// vite.config.tsimport{defineConfig}from'vite'importreactfrom'@vitejs/plugin-react'exportdefaultdefineConfig({plugins: [react()],build: {lib: {entry: 'src/index.tsx',formats: ['es'],fileName: ()=>'index.js',},rollupOptions: {// Bundle React — the host app's React is not exposed to plugins// external: ['react'],},outDir: 'dist',},})
Documentation
License
MIT
About
No description, website, or topics provided.
Resources
Readme
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content

This repository was archived by the owner on Jun 27, 2026. It is now read-only.

BranchesTags
Latest commit
History
5 Commits
Folders and files
NameName
Last commit message
Last commit date
docs
docs
.gitattributes
.gitattributes
README.md
README.md
index.ts
index.ts
package.json
package.json
tsconfig.json
tsconfig.json
types.ts
types.ts
Repository files navigation
Binder Plugin SDK
The official SDK for building plugins for Binder — a developer-focused terminal IDE built with Go + React.
Plugins are installable at runtime through the in-app Plugin Store. They can add new tab types, contribute slash commands to the terminal, and interact with the host application through a sandboxed API.
Quick start
# Clone the plugin template
git clone https://github.com/BinderTools/plugin-template my-plugin
cd my-plugin
npm install
# Build a production bundle
npm run build
# → produces dist/index.js (the plugin bundle)
The Plugin Store fetches dist/index.js from your public GitHub repository's default branch.
How plugins work
  1. A plugin is a single JavaScript file (ESM bundle) that exports a Plugin object as its default export.
  2. When a user installs your plugin from the Plugin Store, Binder downloads dist/index.js from your GitHub repository and caches it locally.
  3. On next launch, the app dynamically loads the cached bundle and registers the plugin.
  4. If your plugin declares a tabType, Binder routes /your-command terminal commands and app:open-tab events with that type to your TabComponent.
Minimal plugin example
importReactfrom'react'importtype{Plugin,PluginTabProps}from'@binder/plugin-sdk'functionMyTab({ context }: PluginTabProps){const{ executeCommand, cwd }=contextreturn(<divstyle={{padding: 16,color: '#ccc'}}><p>Working directory: {cwd??'unknown'}</p><buttononClick={()=>executeCommand?.('ls -la')}>
List files
</button></div>)}constplugin: Plugin={id: 'my-plugin',name: 'My Plugin',description: 'A minimal example plugin.',author: 'your-github-handle',version: '1.0.0',tabType: 'my-plugin',tabTitle: 'my plugin',TabComponent: MyTab,}exportdefaultplugin
Repository structure
Your plugin repository must include:
my-plugin/
dist/
index.js ← compiled ESM bundle (required)
src/
index.tsx ← plugin source
package.json ← metadata (name, version, description, author, pluginId)
README.md

package.json fields
FieldDescription
nameDisplay name shown in the Plugin Store
versionSemver version string
descriptionShort description shown in the Plugin Store
authorAuthor name or GitHub handle
pluginIdUnique kebab-case ID (falls back to the repo name if omitted)
Build setup
Use any bundler that can output a single ESM file. Example with Vite:
// vite.config.tsimport{defineConfig}from'vite'importreactfrom'@vitejs/plugin-react'exportdefaultdefineConfig({plugins: [react()],build: {lib: {entry: 'src/index.tsx',formats: ['es'],fileName: ()=>'index.js',},rollupOptions: {// Bundle React — the host app's React is not exposed to plugins// external: ['react'],},outDir: 'dist',},})
Documentation
License
MIT
About
No description, website, or topics provided.
Resources
Readme
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content

This repository was archived by the owner on Jun 27, 2026. It is now read-only.

BranchesTags
Latest commit
History
5 Commits
Folders and files
NameName
Last commit message
Last commit date
docs
docs
.gitattributes
.gitattributes
README.md
README.md
index.ts
index.ts
package.json
package.json
tsconfig.json
tsconfig.json
types.ts
types.ts
Repository files navigation
Binder Plugin SDK
The official SDK for building plugins for Binder — a developer-focused terminal IDE built with Go + React.
Plugins are installable at runtime through the in-app Plugin Store. They can add new tab types, contribute slash commands to the terminal, and interact with the host application through a sandboxed API.
Quick start
# Clone the plugin template
git clone https://github.com/BinderTools/plugin-template my-plugin
cd my-plugin
npm install
# Build a production bundle
npm run build
# → produces dist/index.js (the plugin bundle)
The Plugin Store fetches dist/index.js from your public GitHub repository's default branch.
How plugins work
  1. A plugin is a single JavaScript file (ESM bundle) that exports a Plugin object as its default export.
  2. When a user installs your plugin from the Plugin Store, Binder downloads dist/index.js from your GitHub repository and caches it locally.
  3. On next launch, the app dynamically loads the cached bundle and registers the plugin.
  4. If your plugin declares a tabType, Binder routes /your-command terminal commands and app:open-tab events with that type to your TabComponent.
Minimal plugin example
importReactfrom'react'importtype{Plugin,PluginTabProps}from'@binder/plugin-sdk'functionMyTab({ context }: PluginTabProps){const{ executeCommand, cwd }=contextreturn(<divstyle={{padding: 16,color: '#ccc'}}><p>Working directory: {cwd??'unknown'}</p><buttononClick={()=>executeCommand?.('ls -la')}>
List files
</button></div>)}constplugin: Plugin={id: 'my-plugin',name: 'My Plugin',description: 'A minimal example plugin.',author: 'your-github-handle',version: '1.0.0',tabType: 'my-plugin',tabTitle: 'my plugin',TabComponent: MyTab,}exportdefaultplugin
Repository structure
Your plugin repository must include:
my-plugin/
dist/
index.js ← compiled ESM bundle (required)
src/
index.tsx ← plugin source
package.json ← metadata (name, version, description, author, pluginId)
README.md

package.json fields
FieldDescription
nameDisplay name shown in the Plugin Store
versionSemver version string
descriptionShort description shown in the Plugin Store
authorAuthor name or GitHub handle
pluginIdUnique kebab-case ID (falls back to the repo name if omitted)
Build setup
Use any bundler that can output a single ESM file. Example with Vite:
// vite.config.tsimport{defineConfig}from'vite'importreactfrom'@vitejs/plugin-react'exportdefaultdefineConfig({plugins: [react()],build: {lib: {entry: 'src/index.tsx',formats: ['es'],fileName: ()=>'index.js',},rollupOptions: {// Bundle React — the host app's React is not exposed to plugins// external: ['react'],},outDir: 'dist',},})
Documentation
License
MIT
About
No description, website, or topics provided.
Resources
Readme
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content

This repository was archived by the owner on Jun 27, 2026. It is now read-only.

BranchesTags
Latest commit
History
5 Commits
Folders and files
NameName
Last commit message
Last commit date
docs
docs
.gitattributes
.gitattributes
README.md
README.md
index.ts
index.ts
package.json
package.json
tsconfig.json
tsconfig.json
types.ts
types.ts
Repository files navigation
Binder Plugin SDK
The official SDK for building plugins for Binder — a developer-focused terminal IDE built with Go + React.
Plugins are installable at runtime through the in-app Plugin Store. They can add new tab types, contribute slash commands to the terminal, and interact with the host application through a sandboxed API.
Quick start
# Clone the plugin template
git clone https://github.com/BinderTools/plugin-template my-plugin
cd my-plugin
npm install
# Build a production bundle
npm run build
# → produces dist/index.js (the plugin bundle)
The Plugin Store fetches dist/index.js from your public GitHub repository's default branch.
How plugins work
  1. A plugin is a single JavaScript file (ESM bundle) that exports a Plugin object as its default export.
  2. When a user installs your plugin from the Plugin Store, Binder downloads dist/index.js from your GitHub repository and caches it locally.
  3. On next launch, the app dynamically loads the cached bundle and registers the plugin.
  4. If your plugin declares a tabType, Binder routes /your-command terminal commands and app:open-tab events with that type to your TabComponent.
Minimal plugin example
importReactfrom'react'importtype{Plugin,PluginTabProps}from'@binder/plugin-sdk'functionMyTab({ context }: PluginTabProps){const{ executeCommand, cwd }=contextreturn(<divstyle={{padding: 16,color: '#ccc'}}><p>Working directory: {cwd??'unknown'}</p><buttononClick={()=>executeCommand?.('ls -la')}>
List files
</button></div>)}constplugin: Plugin={id: 'my-plugin',name: 'My Plugin',description: 'A minimal example plugin.',author: 'your-github-handle',version: '1.0.0',tabType: 'my-plugin',tabTitle: 'my plugin',TabComponent: MyTab,}exportdefaultplugin
Repository structure
Your plugin repository must include:
my-plugin/
dist/
index.js ← compiled ESM bundle (required)
src/
index.tsx ← plugin source
package.json ← metadata (name, version, description, author, pluginId)
README.md

package.json fields
FieldDescription
nameDisplay name shown in the Plugin Store
versionSemver version string
descriptionShort description shown in the Plugin Store
authorAuthor name or GitHub handle
pluginIdUnique kebab-case ID (falls back to the repo name if omitted)
Build setup
Use any bundler that can output a single ESM file. Example with Vite:
// vite.config.tsimport{defineConfig}from'vite'importreactfrom'@vitejs/plugin-react'exportdefaultdefineConfig({plugins: [react()],build: {lib: {entry: 'src/index.tsx',formats: ['es'],fileName: ()=>'index.js',},rollupOptions: {// Bundle React — the host app's React is not exposed to plugins// external: ['react'],},outDir: 'dist',},})
Documentation
License
MIT
About
No description, website, or topics provided.
Resources
Readme
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content

This repository was archived by the owner on Jun 27, 2026. It is now read-only.

BranchesTags
Latest commit
History
5 Commits
Folders and files
NameName
Last commit message
Last commit date
docs
docs
.gitattributes
.gitattributes
README.md
README.md
index.ts
index.ts
package.json
package.json
tsconfig.json
tsconfig.json
types.ts
types.ts
Repository files navigation
Binder Plugin SDK
The official SDK for building plugins for Binder — a developer-focused terminal IDE built with Go + React.
Plugins are installable at runtime through the in-app Plugin Store. They can add new tab types, contribute slash commands to the terminal, and interact with the host application through a sandboxed API.
Quick start
# Clone the plugin template
git clone https://github.com/BinderTools/plugin-template my-plugin
cd my-plugin
npm install
# Build a production bundle
npm run build
# → produces dist/index.js (the plugin bundle)
The Plugin Store fetches dist/index.js from your public GitHub repository's default branch.
How plugins work
  1. A plugin is a single JavaScript file (ESM bundle) that exports a Plugin object as its default export.
  2. When a user installs your plugin from the Plugin Store, Binder downloads dist/index.js from your GitHub repository and caches it locally.
  3. On next launch, the app dynamically loads the cached bundle and registers the plugin.
  4. If your plugin declares a tabType, Binder routes /your-command terminal commands and app:open-tab events with that type to your TabComponent.
Minimal plugin example
importReactfrom'react'importtype{Plugin,PluginTabProps}from'@binder/plugin-sdk'functionMyTab({ context }: PluginTabProps){const{ executeCommand, cwd }=contextreturn(<divstyle={{padding: 16,color: '#ccc'}}><p>Working directory: {cwd??'unknown'}</p><buttononClick={()=>executeCommand?.('ls -la')}>
List files
</button></div>)}constplugin: Plugin={id: 'my-plugin',name: 'My Plugin',description: 'A minimal example plugin.',author: 'your-github-handle',version: '1.0.0',tabType: 'my-plugin',tabTitle: 'my plugin',TabComponent: MyTab,}exportdefaultplugin
Repository structure
Your plugin repository must include:
my-plugin/
dist/
index.js ← compiled ESM bundle (required)
src/
index.tsx ← plugin source
package.json ← metadata (name, version, description, author, pluginId)
README.md

package.json fields
FieldDescription
nameDisplay name shown in the Plugin Store
versionSemver version string
descriptionShort description shown in the Plugin Store
authorAuthor name or GitHub handle
pluginIdUnique kebab-case ID (falls back to the repo name if omitted)
Build setup
Use any bundler that can output a single ESM file. Example with Vite:
// vite.config.tsimport{defineConfig}from'vite'importreactfrom'@vitejs/plugin-react'exportdefaultdefineConfig({plugins: [react()],build: {lib: {entry: 'src/index.tsx',formats: ['es'],fileName: ()=>'index.js',},rollupOptions: {// Bundle React — the host app's React is not exposed to plugins// external: ['react'],},outDir: 'dist',},})
Documentation
License
MIT
About
No description, website, or topics provided.
Resources
Readme
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content

This repository was archived by the owner on Jun 27, 2026. It is now read-only.

BranchesTags
Latest commit
History
5 Commits
Folders and files
NameName
Last commit message
Last commit date
docs
docs
.gitattributes
.gitattributes
README.md
README.md
index.ts
index.ts
package.json
package.json
tsconfig.json
tsconfig.json
types.ts
types.ts
Repository files navigation
Binder Plugin SDK
The official SDK for building plugins for Binder — a developer-focused terminal IDE built with Go + React.
Plugins are installable at runtime through the in-app Plugin Store. They can add new tab types, contribute slash commands to the terminal, and interact with the host application through a sandboxed API.
Quick start
# Clone the plugin template
git clone https://github.com/BinderTools/plugin-template my-plugin
cd my-plugin
npm install
# Build a production bundle
npm run build
# → produces dist/index.js (the plugin bundle)
The Plugin Store fetches dist/index.js from your public GitHub repository's default branch.
How plugins work
  1. A plugin is a single JavaScript file (ESM bundle) that exports a Plugin object as its default export.
  2. When a user installs your plugin from the Plugin Store, Binder downloads dist/index.js from your GitHub repository and caches it locally.
  3. On next launch, the app dynamically loads the cached bundle and registers the plugin.
  4. If your plugin declares a tabType, Binder routes /your-command terminal commands and app:open-tab events with that type to your TabComponent.
Minimal plugin example
importReactfrom'react'importtype{Plugin,PluginTabProps}from'@binder/plugin-sdk'functionMyTab({ context }: PluginTabProps){const{ executeCommand, cwd }=contextreturn(<divstyle={{padding: 16,color: '#ccc'}}><p>Working directory: {cwd??'unknown'}</p><buttononClick={()=>executeCommand?.('ls -la')}>
List files
</button></div>)}constplugin: Plugin={id: 'my-plugin',name: 'My Plugin',description: 'A minimal example plugin.',author: 'your-github-handle',version: '1.0.0',tabType: 'my-plugin',tabTitle: 'my plugin',TabComponent: MyTab,}exportdefaultplugin
Repository structure
Your plugin repository must include:
my-plugin/
dist/
index.js ← compiled ESM bundle (required)
src/
index.tsx ← plugin source
package.json ← metadata (name, version, description, author, pluginId)
README.md

package.json fields
FieldDescription
nameDisplay name shown in the Plugin Store
versionSemver version string
descriptionShort description shown in the Plugin Store
authorAuthor name or GitHub handle
pluginIdUnique kebab-case ID (falls back to the repo name if omitted)
Build setup
Use any bundler that can output a single ESM file. Example with Vite:
// vite.config.tsimport{defineConfig}from'vite'importreactfrom'@vitejs/plugin-react'exportdefaultdefineConfig({plugins: [react()],build: {lib: {entry: 'src/index.tsx',formats: ['es'],fileName: ()=>'index.js',},rollupOptions: {// Bundle React — the host app's React is not exposed to plugins// external: ['react'],},outDir: 'dist',},})
Documentation
License
MIT
About
No description, website, or topics provided.
Resources
Readme
Activity
Custom properties
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages