preguito 0.2.1 → 0.2.3

package/README.md

@@ -1,5 +1,7 @@
 # 🦥 preguito
 
+> 🌐 **[Landing Page](https://jacodoisdois.github.io/preguito)** | 📦 **[npm](https://www.npmjs.com/package/preguito)** | 📚 **[Docs](./docs/)**
+
 > A lazy git CLI with commit templates and shortcuts.
 
 Typing the same commit prefix, squad name, and ticket number over and over is tedious. preguito lets you define a commit template once and reuse it on every commit — single-letter shortcodes replace verbose flags, so you only type what matters.
@@ -25,6 +27,7 @@ Typing the same commit prefix, squad name, and ticket number over and over is te
 - [Configuration](#%EF%B8%8F-configuration)
 - [Programmatic API](#-programmatic-api)
 - [FAQ](#-faq)
+- [Claude Code Integration](#-claude-code-integration)
 - [Contributing](#-contributing)
 - [License](#-license)
 
@@ -65,7 +68,7 @@ npm install -g preguito
 Download the `.deb` from [GitHub Releases](https://github.com/jacodoisdois/preguito/releases) and install:
 
 ```bash
-sudo dpkg -i preguito_0.1.0_amd64.deb
+sudo dpkg -i preguito_0.2.2_amd64.deb
 ```
 
 No Node.js required — the binary bundles everything via Node.js SEA.
@@ -184,7 +187,9 @@ guito u 3                       # Undo last 3 commits
 guito sw main                   # Switch branch
 guito sw -n feature/login       # Create + switch
 guito st                        # Stash changes
+guito st -m "WIP login"         # Stash with message
 guito stp                       # Stash pop
+guito stl                       # List all stashes
 ```
 
 ### Rebase
@@ -202,6 +207,15 @@ guito p                         # Simple push (git push)
 guito pu                        # Push + set upstream
 ```
 
+### Diff
+
+```bash
+guito d                         # Show all changes
+guito d -s                      # Show staged changes only
+guito d --stat                  # Show diffstat summary
+guito d -n                      # Show only changed file names
+```
+
 ### Inspect
 
 ```bash
@@ -274,8 +288,10 @@ See [template-system.md](docs/template-system.md) for full syntax, resolution or
 | `guito re <hash>` | — | Edit rebase at commit |
 | `guito ri <count>` | — | Interactive rebase last N commits |
 | `guito sw <branch>` | `switch` | Switch/create branch (`-n` to create) |
-| `guito st` | — | Stash changes |
+| `guito st` | — | Stash changes (`-m` for message) |
 | `guito stp` | — | Pop latest stash |
+| `guito stl` | — | List all stashes |
+| `guito d` | `diff` | Show changes (`-s` staged, `--stat`, `-n` names) |
 | `guito s` | `status` | Short status |
 | `guito l [count]` | `log` | Compact log (default: 10) |
 | `guito f <keyword>` | `find` | Search commits by message |
@@ -326,6 +342,26 @@ guito ri 5                       # Interactive rebase last 5 commits
 guito cf abc123 -f               # Fixup + force push
 ```
 
+### Review changes before committing
+
+```bash
+guito d                          # See all unstaged changes
+guito d -s                       # See what's staged
+guito d --stat                   # Quick summary of changed files
+guito c 42 f "add feature" -p   # Commit + push
+```
+
+### Stash work in progress
+
+```bash
+guito st -m "WIP: login page"    # Stash with a descriptive message
+guito sw hotfix/urgent-fix       # Switch to another branch
+# ... do urgent work ...
+guito sw -                        # Switch back
+guito stl                        # List stashes to find yours
+guito stp                        # Restore your WIP
+```
+
 ---
 
 ## ⚙️ Configuration
@@ -438,11 +474,27 @@ Yes. During `guito i` setup, you can reassign any letter to any type or environm
 
 ---
 
+## 🤖 Claude Code Integration
+
+preguito has an official [Claude Code skill](https://github.com/jacodoisdois/preguito-skill) that teaches Claude the full `guito` command syntax, template system, and shortcodes.
+
+```bash
+npx skills add jacodoisdois/preguito-skill -g
+```
+
+Once installed, Claude Code will:
+
+- Automatically use `guito c` instead of `git commit` in preguito projects
+- Read your `.preguitorc` config to determine the correct shortcodes and card ID format
+- Offer a `/guito-commit` slash command for interactive commit crafting with dry-run preview
+
+---
+
 ## 🤝 Contributing
 
 ```bash
 git clone https://github.com/jacodoisdois/preguito.git
-cd preguito
+cd preguito/packages/preguito
 npm install
 ```