📚 docs(readme): brew-first docs, gif demo, and release text

Author: o6uoq

.gitignore

@@ -3,3 +3,4 @@
 .gopath/
 /fuzmit
 /git-fuzmit
+*.cast

.goreleaser.yaml

@@ -40,7 +40,7 @@ brews:
       - fuzmit
     directory: Formula
     homepage: "https://github.com/o6uoq/fuzmit"
-    description: "Conventional commits with fuzzy type selection and direct CLI flags"
+    description: "Conventional Commits, but fuzzy"
     commit_author:
       name: "github-actions[bot]"
       email: "41898282+github-actions[bot]@users.noreply.github.com"

README.md

@@ -1,120 +1,60 @@
 # fuzmit
 
-Conventional commits with fuzzy type selection and direct CLI flags.
+Conventional Commit helper CLI with fuzzy prompts and direct flags
 
-`fuzmit` is a standalone binary. If you also want Git subcommand style, install the same binary as `git-fuzmit`.
+## 🎬 Demo
 
-## Run locally
+![fuzmit demo](./fuzmit.gif)
 
-```bash
-go run . --help
-go run . --type fix --scope auth -m "fix nil panic"
-go run . --type feat --scope -m "prompted scope example"
-```
+## 🍺 Install (Homebrew)
 
-## Build locally
+From [o6uoq/homebrew-tap](https://github.com/o6uoq/homebrew-tap):
 
 ```bash
-go build -o fuzmit .
-./fuzmit --help
+brew tap o6uoq/homebrew-tap
+brew install o6uoq/homebrew-tap/fuzmit
 ```
 
-Optional Git-subcommand install:
+## ⚡ Quick start
 
 ```bash
-cp ./fuzmit ~/.bin/git-fuzmit
-git fuzmit --help
+fuzmit --help
+fuzmit --type fix --scope auth -m "handle nil panic"
+fuzmit --type feat -m "add jira scope detection"
+fuzmit --type feat --scope -m "prompt for optional scope"
 ```
 
-## Flags (A-Z)
-
-- `--jira-scope` detect Jira scope from current branch (for example `ABC-123`)
-- `-m, --message <description>` set commit description directly
-- `--no-emojis` disable emojis in commit-type picker/help output
-- `--override` bypass main-branch protection
-- `--scope <scope>` set optional scope directly (requires `--type`)
-- `--scope` (no value) prompt for optional scope interactively (requires `--type`)
-- `--type <type>` set commit type directly (`build|chore|ci|docs|feat|fix|perf|refactor|style|test`)
+## 🧭 Flags
 
-Commit subjects follow Conventional Commits; emojis are included by default and can be disabled with `--no-emojis` or `FUZMIT_NO_EMOJIS=true`.
+- `--type <type>` required commit type: `build|chore|ci|docs|feat|fix|perf|refactor|style|test`
+- `--scope <scope>` optional scope
+- `--scope` prompt for optional scope
+- `--jira-scope` detect scope from branch name (example: `ABC-123`)
+- `-m, --message <description>` set description directly
+- `--no-emojis` disable emojis in picker/help output
+- `--override` bypass main branch protection
 
-## Environment defaults
+## 🧪 Env defaults
 
-`fuzmit` is env-driven. If a variable is unset or invalid, it defaults to `false`.
+- `FUZMIT_SCOPE=true|false` prompt for scope if `--scope` is not provided
+- `FUZMIT_JIRA_SCOPE=true|false` detect Jira scope from branch and ignore `--scope` / `FUZMIT_SCOPE`
+- `FUZMIT_NO_EMOJIS=true|false` disable emojis in commit subjects, menus, and help output
 
-- `FUZMIT_SCOPE=true|false` prompt for scope by default when `--scope` is not provided
-- `FUZMIT_JIRA_SCOPE=true|false` auto-detect Jira scope from branch name; when true, both `--scope` and `FUZMIT_SCOPE` are ignored
-- `FUZMIT_NO_EMOJIS=true|false` disable emojis in picker/help output
-
-Inspect current resolved env settings:
+Inspect resolved env settings:
 
 ```bash
 fuzmit env
 ```
 
-## Jira scope detection
-
-When Jira scope extraction is enabled, `fuzmit` scans the current branch name for an issue key and uses the first match as commit scope.
+## 🚀 Release flow
 
-- Case-insensitive match
-- Normalized to uppercase
-- Expected Jira key shape: `<PROJECT_KEY>-<NUMBER>` (for example `ABCD-12345`)
+- Tag push `v*` triggers GitHub Actions release
+- GoReleaser builds binaries + checksums
+- Tap formula update PR lands in [o6uoq/homebrew-tap](https://github.com/o6uoq/homebrew-tap)
 
-## Pre-commit hooks
-
-Install and enable both `pre-commit` and `commit-msg` hooks:
+Create a release:
 
 ```bash
-pre-commit install --hook-type pre-commit --hook-type commit-msg
-pre-commit run -a
-```
-
-Configured checks:
-
-- `go fmt ./...`
-- `go vet ./...`
-- `go test ./...`
-- `golangci-lint` (official upstream pre-commit hook)
-- Conventional Commit message validation on `commit-msg`
-
-## Homebrew release model
-
-This repo uses tag-driven releases in GitHub Actions:
-
-1. Push a tag matching `v*`
-2. GitHub Actions runs tests and GoReleaser
-3. GoReleaser publishes release artifacts + checksums to GitHub Releases
-4. GoReleaser opens/updates a PR in `o6uoq/homebrew-tap` for `Formula/fuzmit.rb`
-
-Required repository secret in `o6uoq/fuzmit`:
-
-- `HOMEBREW_TAP_GITHUB_TOKEN` (PAT with write access to `o6uoq/homebrew-tap`)
-
-Release workflow file:
-
-- `.github/workflows/release.yml`
-
-GoReleaser config:
-
-- `.goreleaser.yaml`
-
-Example prerelease (before `v0.1.0`):
-
-```bash
-git tag v0.0.1-beta.1
-git push origin v0.0.1-beta.1
-```
-
-Example stable release:
-
-```bash
-git tag v0.1.0
-git push origin v0.1.0
-```
-
-Install from tap:
-
-```bash
-brew tap o6uoq/homebrew-tap
-brew install o6uoq/homebrew-tap/fuzmit
+git tag v0.1.1
+git push origin v0.1.1
 ```