Workflies
Free · one binary · lives in your repo

The issue tracker your AI agents actually use.

Workflies keeps your tickets, your workflow and even your team as plain files in your git repository — then lets people and AI coding agents work the same board, held to the same rules.

The iPhone app is in App Store review. Follow @workfliesapp and we'll let you know the moment it's live.

curl -fsSL https://wflies.com/install.sh | sh

macOS and Linux. Homebrew and Windows too.

What it is

A real project tracker, without the server

Clone the repo and you get the backlog, the next release and the team's operating manual with it. git pull is the sync protocol.

Plain files in git

Tickets, statuses, sprints and members live under .wflies/. Readable in any editor, reviewable in a pull request, yours forever.

Branch protection for tickets

A status can require a Description, acceptance criteria, a linked PR or a human approval before a ticket may enter it. A rejected move says exactly what is missing.

A team of people and agents

Your people and one project agent share one board. Each status carries a plain-language guide that tells whoever holds a ticket — person or agent — what it needs before it may move on.

Built for agents

A built-in MCP server and ready-made skills for Claude Code, Cursor, Codex and VS Code. Agents claim tickets, post progress and move work forward, up to the human gates you set.

Merges that resolve themselves

Two branches edit the same ticket? wflies resolve merges it field by field and records any value that lost in the ticket's audit log.

Your board in your pocket

Pair a phone with a QR code and four matching words. Connect at home, or from anywhere through an end-to-end encrypted relay built so it cannot read your data.

How it works

Airfield: you are the tower

The board is called Airfield. Tickets are planes moving through your statuses. You clear them through the gates you chose; agents are the pilots. Real ticket ids, status names and rule text are always one glance away — the metaphor never hides them.

  • One local binary serves the board, a REST API and the MCP server on 127.0.0.1:7333.
  • The same rules apply whether a change comes from the board, the CLI or an agent.
  • Only a person can override a gate, and the reason is recorded for good.
  • No accounts, no subscription, no cloud copy of your tickets.
Backlog
WF-7k3dExport board as CSV
WF-2m9qDark mode for emails
In progress
WF-a81cRetry failed webhooks
agent
Review
WF-v4esRate-limit the login form
needs you
Done
WF-espcPhone notifications
Get started

From zero to a working board in a minute

Run these inside any git repository. The full walkthrough is in the quickstart.

Install the binary

$ curl -fsSL https://wflies.com/install.sh | sh

Or use Homebrew or the Windows download.

Set up your project

$ cd your-project
$ wflies init                     # .wflies/ with a workflow, status guides and your agent
$ wflies init agent claude-code   # or cursor, codex, vscode

Start the board

$ wflies start                    # http://127.0.0.1:7333, keeps running in the background

Put your agent to work

Create a ticket on the board, then hand it to your agent. In Claude Code:

/wf-ticket WF-7k3d        # carry one ticket as far as it will go
/wf-status ideas          # sweep a whole column

Or just say "work on WF-7k3d". The agent reads the status guide, writes what the status requires, and moves the ticket forward — stopping at the gates that are yours. Approve them from the board's Tower.

Requirements

What you need

Operating system

  • macOS — Apple silicon or Intel
  • Linux — x86_64 or arm64
  • Windows — x86_64

A single static binary. No runtime, no database server.

Software

  • git on your PATH — Workflies uses it for identity, history and merges
  • A git repository for your project
  • A modern web browser for the board

Optional

  • A coding agent: Claude Code, Cursor, Codex or VS Code with Copilot
  • The agent's CLI (claude, codex or cursor-agent) to launch runs from the board
  • An iPhone or Android phone for the phone app (iPhone: in App Store review; Android: coming later)
Download

Download and install

Every release is published at github.com/AharonDL/workflies-releases with a checksums.txt (SHA-256). Pick your platform:

Install script recommended

$ curl -fsSL https://wflies.com/install.sh | sh

The script detects your OS and CPU, downloads the matching archive from the latest release, verifies it against checksums.txt before installing anything, and puts wflies in /usr/local/bin (or ~/.local/bin if that is not writable).

Options, set as environment variables: WFLIES_VERSION=v1.2.3 pins a release, WFLIES_INSTALL_DIR=~/bin picks the directory.

$ curl -fsSL https://wflies.com/install.sh | WFLIES_VERSION=v1.2.3 sh

wflies.com/install.sh forwards to the installer attached to the latest GitHub release; https://github.com/AharonDL/workflies-releases/releases/latest/download/install.sh is the same file.

Homebrew (macOS)

$ brew install --cask aharondl/workflies/wflies

Upgrade later with brew upgrade --cask wflies. The cask clears macOS's download quarantine flag for you.

Windows (x86_64)

  1. Download wflies_<version>_windows_amd64.zip from the latest release.
  2. Unzip it and move wflies.exe to a folder on your PATH (for example %USERPROFILE%\bin).
  3. Open a new terminal and run wflies --version.

Windows on Arm: run the Linux build under WSL. Starting Workflies automatically at login (wflies service install) is macOS and Linux only; on Windows run wflies start.

Manual download

PlatformFile
macOS, Apple siliconwflies_<version>_darwin_arm64.tar.gz
macOS, Intelwflies_<version>_darwin_amd64.tar.gz
Linux, x86_64wflies_<version>_linux_amd64.tar.gz
Linux, arm64wflies_<version>_linux_arm64.tar.gz
Windows, x86_64wflies_<version>_windows_amd64.zip

Verify, extract and install:

$ sha256sum --ignore-missing -c checksums.txt     # macOS: shasum -a 256 --ignore-missing -c checksums.txt
$ tar -xzf wflies_*_linux_amd64.tar.gz
$ sudo mv wflies /usr/local/bin/

macOS builds are not notarised yet. If you downloaded with a browser, clear the quarantine flag once: xattr -d com.apple.quarantine wflies.

Open the latest release

Phone app — iPhone and Android

The Workflies app shows your board, the review queue and your agents' questions on your phone, talking directly to the wflies running on your computer.

The iPhone app is in App Store review. We'll announce it on @workfliesapp and put the App Store link right here as soon as Apple approves it. The Android app is not in Google Play yet.

Your computer is ready for it today:

$ wflies mobile enable     # turn phone access on (off by default), then restart wflies
$ wflies pair              # show a QR code for the phone to scan
$ wflies mobile relay on   # optional: connect from anywhere, end-to-end encrypted

How pairing and the relay work

After installing

$ wflies --version
$ wflies init && wflies init agent claude-code && wflies start

Updating later: install the new binary the same way, then run wflies update in each project. See Update Workflies.

Works with your agent

One command wires up your coding agent

wflies init agent <name> registers the MCP server and writes the onboarding your agent reads.

Claude Code

claude-code — .mcp.json, a managed block in CLAUDE.md, and the /wf-* skills.

Cursor

cursor — .cursor/mcp.json and .cursor/rules/wflies.mdc.

Codex

codex — an AGENTS.md block and .codex/config.toml.

VS Code & Copilot

vscode — .vscode/mcp.json.

Any other MCP client can run wflies mcp over stdio.

Ready when you are.

Free to use. Your tickets live in your repository, not on our servers.