ovw

A terminal overview for your local projects.

ovw scans the project folders you choose and shows what each project is, how active it is, and where you may want to jump back in. Your folders and Git history stay the source of truth.

ovw helps answer:

What projects do I have?
What are they built with?
What changed recently?
What needs attention?

Install

Homebrew:

brew tap roie/tap
brew install ovw

macOS and Linux:

curl -fsSL https://raw.githubusercontent.com/roie/ovw/main/install.sh | sh

Windows:

powershell -c "irm https://raw.githubusercontent.com/roie/ovw/main/install.ps1 | iex"

From source:

git clone https://github.com/roie/ovw
cd ovw
go install .

Prefer manual install? Download a prebuilt binary from releases.

Quick Start

ovw
ovw --help
ovw --version

Use plain or JSON output:

ovw --plain
ovw --json
ovw vibe-oke
ovw parallel-booth --json

TUI

up/down or j/k     move
left/right or h/l  scroll columns
/                  search
f                  filter
s                  sort
c                  columns
enter              details
n                  note
m                  status
p                  pin
a                  add
r                  reload
o                  open
t                  terminal
?                  help
q                  quit

Commands

ovw add <path>               # add project path
ovw hide <name-or-path>      # hide project
ovw unhide <name-or-path>    # show hidden project
ovw --hidden                 # list hidden projects

ovw set <name> --status active
ovw set <name> --note "fix check-in flow"
ovw set <name> --pin
ovw unset <name> --status
ovw unset <name> --note
ovw unset <name> --pin

ovw --status active          # filter by status
ovw --dirty                  # filter dirty projects
ovw --stale                  # filter stale projects
ovw --untagged               # filter projects without status
ovw --sort name:asc          # sort by name
ovw --sort updated:desc      # sort by exact updated time
ovw --sort activity:desc     # sort by activity

ovw config path              # print config path
ovw config edit              # edit config
ovw config setup             # choose project folders again

Config And Data

The table columns follow your config:

columns = ["name", "stack", "activity", "status", "note"]

Available columns:

columns = ["name", "path", "stack", "manager", "scripts", "version", "ports", "branch", "updated", "activity", "status", "note"]

In the TUI, c lets you show, hide, and reorder columns without editing the config file.

The table keeps configured columns stable. The side pane and details view hide empty rows so only available project details are shown.

ovw stores user metadata only: hidden projects, status, notes, and pins. Detected project details such as stack, manager, scripts, version, descriptions, Git activity, recent commits, and recent files are read live from your local files and Git history. The optional ports column inspects running local processes and is only scanned when enabled.

Hiding a project never deletes files.

Uninstall

Homebrew:

brew uninstall ovw
brew untap roie/tap

Remove the binary:

rm "$(go env GOPATH)/bin/ovw"

Remove config and user data:

rm -rf ~/.config/ovw
rm -rf ~/.local/share/ovw

On Windows, remove ovw.exe from your Go bin directory, then remove:

%AppData%\ovw
%LocalAppData%\ovw

Development

go run .
go test ./...
go build ./...
go run ./tools/bump-version <version>

License

MIT