{"id":23876426,"url":"https://github.com/g4-api/g4-vscode-extension","last_synced_at":"2026-06-17T08:32:01.855Z","repository":{"id":270214012,"uuid":"909635290","full_name":"g4-api/g4-vscode-extension","owner":"g4-api","description":"Brings a full visual sequential workflow designer into VS Code, allowing you to build automation flows with drag \u0026 drop directly from your workspace. Seamlessly integrates with VS Code features like AI, extensions, source control, and terminals to turn your editor into a complete automation and orchestration IDE.","archived":false,"fork":false,"pushed_at":"2026-05-26T16:17:17.000Z","size":2384,"stargazers_count":1,"open_issues_count":6,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-26T18:14:38.310Z","etag":null,"topics":["ai-assisted","automation","developer-tools","devops","drag-and-drop","low-code","no-code","orchestration","productivity","qa","rpa","testing","visual-programming","visual-workflow","vscode-extension","workflow","workflow-designer"],"latest_commit_sha":null,"homepage":"https://github.com/g4-api/g4-vscode-extension","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/g4-api.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-29T10:28:26.000Z","updated_at":"2026-05-24T15:34:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"c62e4643-3283-4797-826b-a691056b55d8","html_url":"https://github.com/g4-api/g4-vscode-extension","commit_stats":null,"previous_names":["g4-api/g4-vscode-extension"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/g4-api/g4-vscode-extension","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/g4-api%2Fg4-vscode-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/g4-api%2Fg4-vscode-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/g4-api%2Fg4-vscode-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/g4-api%2Fg4-vscode-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/g4-api","download_url":"https://codeload.github.com/g4-api/g4-vscode-extension/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/g4-api%2Fg4-vscode-extension/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34441283,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assisted","automation","developer-tools","devops","drag-and-drop","low-code","no-code","orchestration","productivity","qa","rpa","testing","visual-programming","visual-workflow","vscode-extension","workflow","workflow-designer"],"created_at":"2025-01-03T19:19:24.458Z","updated_at":"2026-06-17T08:32:01.844Z","avatar_url":"https://github.com/g4-api.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# G4 Engine – Visual Sequential Workflow for VS Code\n\n[![Build, Pack \u0026 Release G4™ VSCode Extension](https://github.com/g4-api/g4-vscode-extension/actions/workflows/pipeline.yaml/badge.svg)](https://github.com/g4-api/g4-vscode-extension/actions/workflows/pipeline.yaml)\n\n![Marketplace](https://img.shields.io/visual-studio-marketplace/v/g4-api.g4-engine-client)\n![Installs](https://img.shields.io/visual-studio-marketplace/i/g4-api.g4-engine-client)\n![Rating](https://img.shields.io/visual-studio-marketplace/r/g4-api.g4-engine-client)\n![License](https://img.shields.io/github/license/g4-api/g4-vscode-extension)\n\n## Table of Contents\n\n1. [Overview](#overview)\n2. [Key Capabilities](#key-capabilities)\n3. [Setup](#setup)\n4. [Quick Start](#quick-start)\n5. [How It Works](#how-it-works)\n6. [Why VS Code](#why-vs-code)\n7. [Project Structure](#project-structure)\n8. [Advanced Configuration: `manifest.json`](#advanced-configuration-manifestjson)\n9. [Requirements](#requirements)\n\n---\n\n## Overview\n\n**G4 Engine – VS Code Extension** brings the **complete visual sequential workflow experience** directly into Visual Studio Code.\n\nPowered by the **Sequential Workflow Designer**, this extension allows you to **design, edit, and run automation workflows visually**, without leaving your editor.\n\nYou can drag \u0026 drop automation assets **directly from the VS Code workspace** into the workflow canvas, combining code, configuration, AI, and orchestration in a single place.\n\nThis turns VS Code into a **full automation and orchestration IDE**.\n\n---\n\n## Key Capabilities\n\n* **Visual Sequential Workflow Designer**\n\n  * Full drag \u0026 drop workflow editing inside VS Code\n  * Real-time rendering and updates\n  * No external browser or standalone app\n\n* **Workspace-Native Drag \u0026 Drop**\n\n  * Drag automation files directly from the VS Code Explorer\n  * Supports multi-select and standard VS Code drag behavior\n  * Tight coupling between workflows and project files\n\n* **Native VS Code Integration**\n\n  * Commands via Command Palette\n  * Status bar G4 connection indicator\n  * Dedicated Activity Bar (tools panel) integration\n\n* **Extensible \u0026 AI-Ready**\n\n  * Works seamlessly with Copilot and other AI extensions\n  * Integrates with Git, CI/CD tools, terminals, and debuggers\n\n---\n\n## Setup\n\n### 1. Install the Extension\n\nInstall from the VS Code Marketplace or from a `.vsix` file:\n\n```bash\ncode --install-extension g4-engine-client.vsix\n```\n\n---\n\n### 2. Create a New G4 Project\n\nOpen the **Command Palette** and run:\n\n```none\nG4: Create New Project\n```\n\nThis initializes the required G4 project structure in your workspace.\n\n---\n\n### 3. Verify G4 Connection\n\nCheck the **VS Code status bar**:\n\n* A visible **G4 status indicator** confirms the backend is connected\n* If disconnected, ensure the G4 backend is running and reachable\n\n---\n\n### 4. Open the G4 Workflow Editor\n\n1. Click the **G4 icon** in the **Activity Bar** (left-side panel)\n2. Select **“Open G4 Workflow Editor”**\n\nThe **Visual Sequential Workflow Designer** opens inside VS Code.\n\n---\n\n## Quick Start\n\n1. Open the **G4 Workflow Editor**\n2. In the VS Code **Explorer**, locate automation files\n3. **Drag \u0026 drop files directly onto the workflow canvas**\n\n   * Use the standard **VS Code Shift-drag trick** when needed\n4. Visually connect steps and configure them\n5. Save and run the workflow using G4 commands\n\nEverything happens **inside VS Code**, with full workspace awareness.\n\n---\n\n## How It Works\n\nThe extension embeds the **Sequential Workflow Designer** using native VS Code APIs:\n\n* **Tree Providers** expose G4 assets in the workspace\n* **WebView Views** host the workflow editor and recorder UI\n* **Commands** manage project creation, workflow loading, and execution\n* **Status Bar Integration** reflects live connection state\n\nThis ensures performance, stability, and a first-class VS Code experience.\n\n---\n\n## Why VS Code\n\nBy running inside VS Code, G4 Engine automatically gains:\n\n* AI assistance (Copilot, Chat, and custom AI extensions)\n* Git and source control integrations\n* CI/CD tooling and terminals\n* Familiar shortcuts, theming, and layouts\n* A massive extension ecosystem\n\nG4 doesn’t replace your editor — it **turns it into an automation IDE**.\n\n---\n\n## Project Structure\n\nThe G4 project structure is **alphabetically ordered**, exactly as it appears in VS Code:\n\n```none\n.\n├── .github/\n│   └── instructions/\n│       ├── copilot-new-bot.instructions.md\n│       └── copilot-new-flow.instructions.md\n├── .vscode/\n│   └── mcp.json\n├── bots/\n├── configurations/\n├── environments/\n├── models/\n├── prompts/\n├── resources/\n├── templates/\n├── workflows/\n├── .env\n└── manifest.json\n```\n\n### Notes\n\n* **`.github/instructions`**\n  Copilot instruction files that guide AI-assisted creation of bots and workflows.\n\n* **`.vscode/mcp.json`**\n  MCP / Copilot integration configuration for VS Code.\n\n* **Domain folders** (`bots`, `workflows`, `models`, etc.)\n  First-class G4 concepts, directly usable from the workflow designer via drag \u0026 drop.\n\n---\n\n## Advanced Configuration: `manifest.json`\n\nThe `manifest.json` file is the **central runtime configuration** for a G4 project.\n\nIt controls connectivity, drivers, automation behavior, recorders, diagnostics, and artifacts.\n\n### G4 Server Connection\n\n```json\n\"g4Server\": {\n  \"schema\": \"http\",\n  \"host\": \"localhost\",\n  \"port\": \"9944\"\n}\n```\n\nSupports local, remote, clustered, or air-gapped deployments.\n\n---\n\n### Authentication\n\n```json\n\"authentication\": {\n  \"token\": \"\"\n}\n```\n\nTypically injected via `.env` or CI secrets.\n\n---\n\n### Driver Parameters\n\n```json\n\"driverParameters\": {\n  \"driver\": \"ChromeDriver\",\n  \"driverBinaries\": \"http://localhost:4444/wd/hub\"\n}\n```\n\nDefines default execution drivers and remote hubs.\n\n---\n\n### Automation Settings\n\n```json\n\"automationSettings\": {\n  \"loadTimeout\": 60000,\n  \"maxParallel\": 1,\n  \"returnFlatResponse\": true,\n  \"returnStructuredResponse\": true,\n  \"searchTimeout\": 15000\n}\n```\n\nControls execution limits, parallelism, and response formats.\n\n---\n\n### Client Logging\n\nControls client-side and agent logging behavior. Part of `settings`.\n\n```json\n\"clientLogConfiguration\": {\n  \"agentLogConfiguration\": {\n    \"enabled\": true,\n    \"interval\": 1000\n  },\n  \"logLevel\": \"information\",\n  \"sourceOptions\": {\n    \"filter\": \"include\",\n    \"sources\": []\n  }\n}\n```\n\n---\n\n### Recorder Settings\n\nSupports local or distributed recording.\n\n```json\n{\n    \"recorderSettings\": {\n        \"enabled\": true,\n        \"recorders\": [\n            {\n                \"mode\": \"user32\",\n                \"schema\": \"http\",\n                \"host\": \"localhost\",\n                \"port\": \"9955\",\n                \"driverParameters\": {\n                    \"capabilities\": {\n                        \"alwaysMatch\": {\n                            \"browserName\": \"Uia\",\n                            \"uia:options\": {\n                                \"label\": \"machine-a\"\n                            }\n                        }\n                    },\n                    \"driver\": \"UiaDriver\",\n                    \"driverBinaries\": \"http://localhost:5555/wd/hub\",\n                    \"firstMatch\": [\n                        {}\n                    ]\n                },\n                \"thinkTimeSettings\": {\n                    \"enabled\": true,\n                    \"maxThinkTime\": 2000,\n                    \"minThinkTime\": 2000\n                }\n            },\n            ...\n        ]\n    }\n}\n```\n\nIncludes machine labeling, think-time simulation, and remote drivers.\n\n---\n\n### Diagnostics \u0026 Artifacts\n\n* Exception handling\n* Performance metrics\n* Screenshot capture\n\nUsed for debugging, CI pipelines, and analytics.\n\n---\n\n### When to Modify `manifest.json`\n\nCustomize this file when:\n\n* Connecting to remote or clustered G4 backends\n* Enabling recorders or distributed execution\n* Running in CI/CD pipelines\n* Operating in offline or air-gapped environments\n\n---\n\n## Requirements\n\n* **Visual Studio Code** `^1.105.0`\n* Node.js (for extension development/build)\n* A compatible **G4 Engine backend** (local or remote)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fg4-api%2Fg4-vscode-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fg4-api%2Fg4-vscode-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fg4-api%2Fg4-vscode-extension/lists"}