Skip to main content

​
Welcome to Progflow

Progflow is a lightweight CLI tool that lets you define reusable workspace configurations called flows. Each flow captures everything you need to start working on a project: the working directory, editor command, URLs to open, environment variables, and shell. Activate a flow in one command. Stop it and save a note so you never forget where you left off.

Installation

Install the single static binary on Linux or Termux

Quick Start

Create and activate your first flow in under two minutes

Command Reference

All six commands with flags, options, and real examples

Flow Configuration

Understand the JSON config format and every field

Use Cases

Real-world examples for development, monitoring, and more

Termux Guide

Run Progflow on Android with Termux

​
Get up and running

1

Install Progflow

Run the one-line installer to build and install the binary:
curl -sSL https://raw.githubusercontent.com/Rehanasharmin/Progflow/master/install.sh | bash
2

Create your first flow

Run progflow new and answer the prompts to configure your workspace:
progflow new myproject
# Working directory: /home/you/projects/myapp
# Editor command: nvim .
# URLs to open: https://github.com/you/myapp
# Shell: /bin/bash
# Environment variables: NODE_ENV=development
3

Activate the flow

Start your workspace with a single command:
progflow on myproject
# ✓ flow 'myproject' started — editor, 1 url
4

Stop and save context

When you’re done, stop the flow and optionally save a note:
progflow off myproject
# Save a context note? [y/N]: y
# Enter note: Debugging auth issue in JWT middleware
# ✓ flow 'myproject' stopped
Flows are plain JSON files stored in ~/.config/flow/. You can edit them directly or use progflow edit <name> to open them in your $EDITOR.

Build docs developers (and LLMs) love

Get started for freeTalk to us