Kanban as it should be. Not as it has been.
K

Kanban as it should be. Not as it has been.

Kanban as it should be. Not as it has been.

7,915 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

Kanban, But Make It Fizzy

If you've ever set up a digital Kanban board, you know the drill: you create columns, you add cards, you drag things around. It works, but it often feels heavy. It feels like software designed for process managers, not for the actual flow of getting things done. What if a Kanban board was just a simple, fast, text file you could edit anywhere?

That's the itch that Basecamp's new project, Fizzy, is trying to scratch. It’s a fresh take on the Kanban board that throws out the complex UI and database backends in favor of something beautifully simple and developer-friendly.

What It Does

Fizzy is a local, terminal-based Kanban board. Instead of a web app with buttons and forms, your board is a plain text file (a Markdown file, to be precise). You edit the board by editing the file, and Fizzy renders it as a clean, column-based view right in your terminal. Move a task by moving a line of text. It’s version control friendly, portable, and instantly understandable.

Why It's Cool

The cleverness here is in the constraints. By using a Markdown file as the data store, Fizzy gets a lot for free:

  • Zero Lock-in: Your board is just a file. You can edit it with Vim, VS Code, or even cat it out. No proprietary format.
  • Git-Friendly: Since it's a text file, tracking your project's workflow history becomes a natural side effect of your commits. You can see how your board evolved over time.
  • Blazing Fast: There's no UI to load, no network latency. It's just your terminal rendering a file. It feels instantaneous.
  • Always Available: Need to check your priorities from a SSH session on a server? Just run fizzy. No login, no internet required.

It takes the core idea of Kanban—visualizing your work in columns—and strips it back to its absolute essence. It’s Kanban for people who live in the terminal and think in plain text.

How to Try It

The project is up on GitHub. Since it's a Ruby gem, getting started is straightforward.

First, install the gem:

gem install fizzy

Then, navigate to a project directory and create your board file. Fizzy expects a file named board.md. You can start with their template:

fizzy new

This creates a board.md file with some example columns (Backlog, Doing, Done). Open that file in your editor, add tasks as list items (- Task name), and save. Then, just run:

fizzy

Your Kanban board will render in the termi

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Dec 4, 2025