Terminal Grid Personal

Personal source fork of Terminal Grid, kept under the upstream MIT license.

This fork exists to make local hotfixes durable at source level instead of editing the installed Marketplace extension directory.

Personal Changes

• Extension identity is neliro.terminal-grid-personal.
• Display name is Terminal Grid Personal.
• Commands use the terminalGridPersonal.* prefix.
• Settings use the terminalGridPersonal.* namespace.
• Webview panel type is terminalGridPersonal.
• Sidebar view id is terminalGridPersonal.sidebarView.
• MCP config key and server name are terminal-grid-personal.
• MCP bridge default port is 7891.
• Shift+Enter and macOS Command+Enter in terminal cells send CSI-u Shift+Enter bytes: \x1B[13;2u.
• Modifier-click terminal links are routed through the extension host:
  • macOS: Command-click
  • other platforms: Ctrl-click
  • HTTP/HTTPS links open externally.
  • File links open in the VS Code editor when the target exists.
• Modifier-click link opening clears terminal selection/focus state before switching editor tabs.
• Keyboard copy and context-menu plain copy join soft-wrapped terminal rows into paragraphs while preserving real terminal row breaks.

Plain Enter and plain click behavior are intentionally unchanged.

Build

npm install
npm test
npm run compile
npm run package

npm run compile only builds local bundles. It does not install, extract, remove, or reload any VS Code extension.

npm run package writes a local development VSIX named like:

terminal-grid-personal-0.4.4.vsix

Local VSIX files are build artifacts and should not be committed once Marketplace publishing is the release path.

Marketplace Installation

After the Marketplace listing exists, install this fork by extension ID:

code --install-extension neliro.terminal-grid-personal

Future updates then come through VS Code's normal extension update flow.

If you previously installed this fork from a local VSIX, switch over once:

code --uninstall-extension neliro.terminal-grid-personal
code --install-extension neliro.terminal-grid-personal

Manual VSIX Installation

Manual VSIX installation remains useful for development testing before a Marketplace publish:

code --install-extension terminal-grid-personal-0.4.4.vsix

If upstream koenma.terminal-grid is installed at the same time, disable whichever extension you do not want active in that VS Code profile. This fork uses distinct commands, settings, views, MCP names, and default API port so it can coexist more safely, but both extensions still provide similar user-facing functionality.

Marketplace Release

Future releases are published by .github/workflows/publish-marketplace.yml.

One-time setup:

• Create or verify the Marketplace publisher neliro.
• Add a repository Actions secret named VSCE_PAT.
• Publish the first Marketplace version by manually running the workflow with mode = publish.

Normal updates:

git tag v0.4.5
git push origin v0.4.5

The tag must match package.json exactly. See docs/marketplace-release.md for the full operator checklist.

Agent API

const info = await vscode.commands.executeCommand("terminalGridPersonal.getGridInfo");
await vscode.commands.executeCommand("terminalGridPersonal.sendToCell", 0, "echo hello\r");
const output = await vscode.commands.executeCommand("terminalGridPersonal.readCell", 0, 10);

MCP

The bridge listens on 127.0.0.1 only. The default port is 7891 and can be changed with terminalGridPersonal.apiPort.

The manual Claude Desktop MCP entry key is terminal-grid-personal and points to the packaged mcp-server.js.

Upstream License

Terminal Grid is licensed under MIT. Keep upstream license notices intact when redistributing or modifying this fork.