Skip to content

update readme #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 55 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,19 @@
# windmill
# Windmill VSCode Extension

Companion of the OSS developer platform windmill.dev for local development and
editing of scripts including flow's inline scripts using VSCode.

[Install it](https://marketplace.visualstudio.com/items?itemName=windmill-labs.windmill)
![demo](./main.png)

## Installation

1. Open VSCode and click on the Extensions icon on the Activity Bar on the side of the window.
2. Search for "Windmill" and select the Windmill extension by Windmill Labs.
3. Click on the Install button.

![demo](./wm-install.png)

You can also follow this link to the extension page on the VSCode marketplace: [Install it](https://marketplace.visualstudio.com/items?itemName=windmill-labs.windmill)

## Quick Start

Expand All @@ -19,6 +29,47 @@ Once done, on any page you'd like to edit, run:

The keybidings for that command are: Ctrl+Enter and Shfit+Enter.

![image](https://github.com/windmill-labs/windmill-vscode/assets/275584/5c6137bf-c56d-46e5-ba72-2fd5806ce0dc)
## Features

- The extension will automatically detect the current scripts and load the schema.
- Run your scripts and preview the output within VSCode.
- Review logs and results
- Check run history

## Commands

Access these commands through the Command Palette (Ctrl/Cmd+Shift+P):

| Command | Description |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Windmill: Show Preview** | This command launches a preview of your script in a new tab. |
| **Windmill: Run Preview** | Runs the current script and provides a preview within the VSCode environment. This feature lets you preview your work without leaving your code editor. |
| **Windmill: Configure Remote, Workspace, and Token** | Opens a setup wizard to configure your environment. This includes settings for the remote URL, workspace, and user token. You only need to do this once or when changing your environment settings. |
| **Windmill: Switch Windmill Workspace** | Allows you to switch between different workspaces. |
| **Windmill: Add a Workspace** | Adds a new workspace to your configuration. |

## Settings

The extension provides the following settings:

| Setting | Description |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `windmill.remote` | The full remote URL including http and trailing slash. By default, it's "https://app.windmill.dev/". |
| `windmill.workspaceId` | The workspace id to use. |
| `windmill.token` | The token to use to authenticate with the remote and workspace. |
| `windmill.additionalWorkspaces` | The list of additional remotes to use. This allows you to set up multiple workspaces for different projects. |
| `windmill.currentWorkspace` | The workspace name currently used (if multiple). main or empty is the default one. |

![demo](./wm-settings.png)

You can create a user token in the Windmill app. Follow the instructions in the [Windmill docs](https://docs.windmill.dev/docs/core_concepts/webhooks#user-token).

## Usage

1. Setup: After installing the extension, use the Windmill: Configure Remote, Workspace and Token command to setup your Windmill environment.

2. Run Scripts: Use the Windmill: Show Preview or Windmill: Run Preview command to run your scripts and preview the output within VSCode.

3. Switch Workspaces: Use the Windmill: Switch Windmill Workspace command to switch between your Windmill workspaces.

![demo](./demo.gif)
4. Add Workspaces: If you work with multiple projects, use the Windmill: Add a Windmill Workspace command to add a new workspace.
Binary file added main.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added wm-install.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added wm-settings.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.