Electivus Copilot Bridge for Flosum

Visual Studio Code extension that registers GitHub Copilot language-model tools mapped to flosum-sfdx-plugin commands. This project is maintained by Electivus; it is an independent, unofficial integration and is not affiliated with or endorsed by Flosum. The goal is to enable AI-guided automations even in environments where the Model Context Protocol (MCP) is unavailable.

Features

• Tool registration for listing Flosum repositories and branches.
• Branch creation and cloning initiated directly from Copilot.
• Execution of flosum:source:pull and flosum:source:push with confirmation gates before write operations.
• Quick check of the Flosum license in the authenticated Salesforce org.
• Settings to customize the sfdx path, working directory, and default usernames.
• Optional execution through the integrated VS Code terminal for environments where background CLI processes are blocked.
• Automatic normalization of path arguments (Windows \ → /) with smart fallbacks for --custom-path to avoid known Flosum CLI quirks.

Prerequisites

1. Visual Studio Code 1.95.0 or later (required for the vscode.lm API).
2. Salesforce CLI installed and authenticated against the relevant orgs.
3. flosum-sfdx-plugin installed in Salesforce CLI (sfdx plugins:install flosum-sfdx-plugin).
4. GitHub Copilot or another Language Model Tools participant enabled in your VS Code instance.

Getting Started

1. Locate Electivus Copilot Bridge for Flosum in the VS Code Extensions view (Ctrl+Shift+X) and install it.
2. Confirm that Copilot is enabled in the target workspace and that your Salesforce CLI environment is authenticated.
3. Review the extension settings to tailor default usernames, working directory, and CLI path to your org structure.

Key Settings (flosumAiTools)

• sfdxPath: absolute path or executable name for sfdx.
• workingDirectory: directory where commands are executed; defaults to the open workspace when empty.
• useIntegratedTerminal: defaults to enabled; routes commands through the default integrated terminal shell (requires shell integration support) and falls back to background execution if unavailable.
• defaultTargetUsername: default alias/username applied to --targetusername.
• defaultTargetDevHubUsername: default alias/username applied to --targetdevhubusername.
• defaultApiVersion: enforces a specific API version on SFDX calls.

Registered Tools

Input schemas are declared in package.json so Copilot understands the parameters it can provide.

Using With Copilot

1. Open the Copilot chat within VS Code.
2. Prompt Copilot, for example: List available Flosum repositories.
3. Attach the desired tool using #flosum_repository_list (tool completions appear when typing #).
4. Copilot runs the SFDX command, returning a structured response.

For destructive operations (such as source:push or branch:create), Copilot surfaces a confirmation dialog before execution.

Roadmap

• Expand coverage to additional plugin commands such as pipeline operations and auditing tools.
• Add automated tests using vscode-test and mocked CLI recordings.
• Provide real-time diagnostics about sfdx authentication status.

Support

• Report issues and feature requests at github.com/Electivus/electivus-copilot-flosum-bridge.
• Share feedback with the Electivus team via GitHub Discussions or pull requests.

Contributing

npm install
npm run compile
code .

Run the Run Extension launch configuration (F5) to load a development host window. Ensure Copilot is active so the registered tools appear for validation.

License

MIT