Introduction

Windshift is a self-hosted work management platform for software teams. It provides task tracking, workflow automation, test management, time tracking, and team collaboration on your infrastructure.

Key Features

  • Work Management: Boards, backlogs, lists, tree views, and personal dashboards for organizing tasks.
  • Coding Agents: Assign work items to AI agents in a runner pool. They open pull requests and report live progress.
  • Mobile App: Installable PWA at /m with push notifications, item details, and an AI assistant.
  • REST API: Versioned /rest/api/v1 API with scoped tokens for integrations and embeds.
  • Workflow Automation: Custom workflows with configurable statuses and transitions.
  • Test Management: Test cases, test runs, and step-based test plans.
  • Time Tracking: Built-in time logging on tasks and workspaces.
  • Customer Portals: External portals for customer feedback and requests.
  • SCM Integration: Connect GitHub, Gitea, and Forgejo for branch links and status sync. Forgejo uses the Gitea provider.
  • SSO & Authentication: OIDC, SAML, LDAP, and WebAuthn/FIDO2 support SAML/LDAP: Pro
  • SCIM 2.0: User provisioning from your identity provider Requires Pro
  • Plugin System: Extend Windshift with WASM-based plugins that use the Extism runtime.
  • CLI Tool: The ws command-line client for managing tasks and workspaces from the terminal.
  • SSH TUI: Terminal access over SSH.
  • Jira Import: Migrate existing projects from Jira.

Tech Stack

Windshift is built with:

  • Backend: Go (standard library HTTP server)
  • Frontend: Svelte 5, Vite, Tailwind CSS
  • Database: SQLite (default) or PostgreSQL
  • Plugins: Extism / WebAssembly

Architecture

Windshift ships as one binary. The build embeds the frontend in the Go binary. You do not need a separate web server. Start the binary and configure a database.

SQLite is the default database and works well for most teams. Use PostgreSQL for larger deployments or write-heavy workloads.

Next Steps