workflow

bk's personal workflow tools and scripts.
Each tool lives under tools/<name> and ships on its own.

---

Tools

Tool	What it does
flo	Local git workflow helper (Graphite-style): sync, stacked branches, draft-PR submit.
claude	Claude Code customizations

Layout

workflow/
├── tools/
│   └── flo/             # each tool is self-contained
├── docs/
│   └── flo/             # per-tool docs (commands + installation)
├── Formula/             # Homebrew taps
└── package.json         # pnpm workspace root

Installing a tool

Two install paths:

Homebrew (end users — see docs/flo/installation.md for the full install & release guide):

brew tap brunokiafuka/workflow https://github.com/brunokiafuka/workflow
brew install --HEAD flo

Local dev install (when hacking on a tool):

pnpm install
pnpm run install:flo    # symlinks ~/.local/bin/flo

Philosophy

• Scripts over services. Small, local, reversible.
• One tool, one job. No shared runtime — each tool owns its dependencies under tools/<name>.
• Boring stack. TypeScript + tsx, no bundler, no framework.