Windmill Labs
Windmill

Local development

Develop locally, deploy to Windmill

The Windmill CLI syncs your workspace to a local folder. Edit scripts and flows in any editor, push changes back with one command.

npm install -g windmill-cli

Local development for Windmill

Write and test scripts in your own editor, IDE, or AI coding assistant. The Windmill CLI keeps your local files and remote workspace in sync.

Sync your workspace to a local folder

wmill sync pull downloads your entire workspace as plain files: scripts, flows, apps, resources, triggers, and variables. Edit anything locally, then wmill sync push to deploy. Both commands support path filters to sync specific folders.

Read the docs

VS Code extension

The Windmill VS Code extension previews auto-generated UIs while you write scripts, tests scripts and flows from the editor, and validates flow YAML in real time. Bidirectional editing lets you switch between the YAML file and a visual flow editor.

Read the docs

Built-in skills and AGENTS.md

Run wmill init to generate context files and skill files for Claude Code, Cursor, and other AI tools. The generated AGENTS.md teaches assistants Windmill's file structure, script conventions, and deployment workflow. AI tools can also connect to a workspace through the MCP server to execute scripts, manage resources, and monitor jobs directly.

Read the docs

Create scripts, flows, and apps from the CLI

Scaffold new items locally with one command. The CLI generates the file structure Windmill needs for deployment.

Script

$ wmill script new <path> <lang>
fetch_orders.py
fetch_orders.script.yaml
fetch_orders.lock

Scaffold a script in any of 20+ languages with its metadata and lockfile.

Read the docs

Flow

$ wmill flow new <path>
flow.yaml
step_1.inline_script.ts
step_2.inline_script.py

Scaffold a flow folder with a YAML definition and inline scripts.

Read the docs

Full-code app

$ wmill app new
App.tsx
raw_app.yaml
backend/get_users.ts

Scaffold a React or Svelte app with backend runnables and a dev server.

Read the docs

Build apps in your editor, ship on Windmill

Use wmill app dev to scaffold and develop full-code apps locally with AI assistants and your favorite editor. Deploy to get a production-ready app with authentication, permissions, and audit logs built in.

Read the docs

Deploy and sync to Git

wmill sync push deploys to your Windmill workspace and, when Git Sync is enabled, automatically commits the changes to your repository. Changes can also be pulled from Git via CI/CD pipelines, making Git the single source of truth. For staging and production workflows, see versioning and deployment.

Read the docs

From local to remote

Change locally
Git sync on
git commit & push
GitHub Action: wmill sync pushauto
No git sync
wmill sync push
Deployed on Windmillauto

From remote to local

Deploy from the UI
Git sync on
Commit to Gitauto
git pull
No git sync
wmill sync pull
Files updated locallyauto

Frequently asked questions

Build your internal platform on Windmill

Scripts, flows, apps, and infrastructure in one place.