gut-cli 0.1.5 → 0.1.7

package/README.md

@@ -17,11 +17,13 @@ All AI commands support short aliases (without `ai-` prefix):
 | `gut ai-commit` | `gut commit` | Generate commit messages |
 | `gut ai-pr` | `gut pr` | Generate PR descriptions |
 | `gut ai-review` | `gut review` | Code review |
-| `gut ai-diff` | `gut diff` | Explain changes |
 | `gut ai-merge` | `gut merge` | Resolve merge conflicts |
-| `gut ai-explain` | `gut explain` | Explain commits, PRs, or files |
+| `gut ai-explain` | `gut explain` | Explain changes, commits, PRs, or files |
 | `gut ai-find` | `gut find` | Find commits by vague description |
+| `gut ai-branch` | `gut branch` | Generate branch names from description |
 | `gut changelog` | - | Generate changelogs |
+| `gut sync` | - | Sync with remote (fetch + rebase/merge) |
+| `gut stash` | - | Stash with AI-generated names |
 
 ### `gut commit`
 
@@ -88,24 +90,6 @@ gut review 123
 gut review --json
 ```
 
-### `gut diff`
-
-Get an AI-powered explanation of your changes.
-
-```bash
-# Explain all uncommitted changes
-gut diff
-
-# Explain staged changes only
-gut diff --staged
-
-# Explain specific commit
-gut diff --commit abc123
-
-# Output as JSON
-gut diff --json
-```
-
 ### `gut merge`
 
 Merge branches with AI-powered conflict resolution.
@@ -123,17 +107,14 @@ gut merge feature/login --no-commit
 
 ### `gut explain`
 
-Get AI-powered explanations of commits, PRs, or file contents.
+Get AI-powered explanations of changes, commits, PRs, or file contents.
 
 ```bash
-# Explain a file's purpose and contents (default)
-gut explain src/index.ts
-
-# Explain file's recent change history
-gut explain src/index.ts --history
+# Explain uncommitted changes (default)
+gut explain
 
-# Explain multiple recent commits for a file
-gut explain src/index.ts --history -n 5
+# Explain staged changes only
+gut explain --staged
 
 # Explain a specific commit
 gut explain abc123
@@ -143,8 +124,17 @@ gut explain HEAD
 gut explain 123
 gut explain #123
 
+# Explain a file's purpose and contents
+gut explain src/index.ts
+
+# Explain file's recent change history
+gut explain src/index.ts --history
+
+# Explain multiple recent commits for a file
+gut explain src/index.ts --history -n 5
+
 # Output as JSON
-gut explain src/index.ts --json
+gut explain --json
 ```
 
 **Project Context Support**: Create `.gut/explain.md` to provide project-specific context for better explanations.
@@ -180,6 +170,75 @@ gut find "authentication" --json
 
 **Project Context Support**: Create `.gut/find.md` to provide project-specific context for better search results.
 
+### `gut branch`
+
+Generate branch names from GitHub issue or description using AI.
+
+```bash
+# Generate branch name from issue number (requires gh CLI)
+gut branch 123
+gut branch #123
+
+# Auto-checkout the branch
+gut branch 123 --checkout
+
+# Specify branch type
+gut branch 123 --type fix
+
+# Use description instead of issue
+gut branch -d "add user authentication"
+```
+
+**Branch Convention Support**: Create `.gut/branch-convention.md` for custom naming rules.
+
+### `gut sync`
+
+Sync current branch with remote (fetch + rebase).
+
+```bash
+# Sync current branch (rebase by default)
+gut sync
+
+# Use merge instead of rebase
+gut sync --merge
+
+# Auto-stash changes before sync
+gut sync --stash
+
+# Force sync with uncommitted changes
+gut sync --force
+```
+
+### `gut stash`
+
+Stash changes with AI-generated descriptive names.
+
+```bash
+# Stash with AI-generated name
+gut stash
+
+# Stash with custom name
+gut stash "working on auth"
+
+# List all stashes
+gut stash --list
+
+# Apply latest stash
+gut stash --apply
+
+# Apply specific stash
+gut stash --apply 2
+
+# Pop stash
+gut stash --pop
+
+# Drop stash
+gut stash --drop 1
+
+# Clear all stashes
+gut stash --clear
+```
+
 ### `gut changelog`
 
 Generate a changelog from commits.
@@ -252,6 +311,7 @@ gut looks for these configuration files in your repository:
 | `.gut/merge-strategy.md` | Merge conflict resolution rules |
 | `.gut/explain.md` | Project context for explanations |
 | `.gut/find.md` | Project context for commit search |
+| `.gut/branch-convention.md` | Custom branch naming rules |
 | `.github/pull_request_template.md` | PR template (fallback) |
 | `CHANGELOG.md` | Changelog style (fallback) |