gdx 0.1.2 → 0.3.0

package/README.md

@@ -87,21 +87,27 @@ Your compiled binary will be in `./dist/` folder.
 
 ### Optional: Shell Integration
 
-To enable features like `gdx parallel switch` (auto-cd into worktrees), you need to add shell integration.
+To enable features like `gdx parallel switch` (auto-cd into worktrees) and **tab completion**, you need to add shell integration.
 
-To do this add the following line to the **End** of your shell profile (`~/.bashrc`, `~/.zshrc`, etc.):
+Shell integration provides:
+
+- **Auto-cd support**: Allows `gdx parallel switch` to change directories
+- **Tab completion**: Intelligent completion for gdx commands, shorthands, and git subcommands
+- **Git fallback**: Falls back to native git completion when gdx has no suggestions (git fallback requires you to install git's completion scripts separately)
+
+To add shell integration, add the following line to the **End** of your shell profile (`~/.bashrc`, `~/.zshrc`, etc.):
 
 #### For bash and zsh:
 
 ```bash
-eval "$(gdx --init --shell bash)"  # for bash
-eval "$(gdx --init --shell zsh)"   # for zsh
+eval "$(gdx --init bash)"  # for bash
+eval "$(gdx --init zsh)"   # for zsh
 ```
 
 #### For fish:
 
 ```fish
-gdx --init --shell fish | source
+gdx --init fish | source
 ```
 
 #### For PowerShell:
@@ -109,12 +115,12 @@ gdx --init --shell fish | source
 To find your profile path, run `$PROFILE` in PowerShell.
 
 ```powershell
-Invoke-Expression (& { (gdx --init --shell pwsh | Out-String) })
+Invoke-Expression (& { (gdx --init pwsh | Out-String) })
 ```
 
 > [!TIP]
-> you can add `--cmd` to the `gdx --init` command to create custom aliases.
-> For example, `gdx --init --shell zsh --cmd g` will create `g` as an alias for `gdx`.
+> You can add `--cmd` to the `gdx --init` command to create custom aliases.
+> For example, `gdx --init zsh --cmd g` will create `g` as an alias for `gdx`.
 
 ## Core Features
 
@@ -133,6 +139,8 @@ gdx reset ~2      # -> git reset HEAD~2
 
 > [!NOTE]
 > This wrapper forwards unrecognized commands directly to `git`, so you can use it as a full git replacement.
+>
+> If GDX still gets in your way, just run `gdx --bypass <git-commands>` to skip gdx intervention altogether.
 
 ### 2. Smart Linting
 
@@ -165,6 +173,11 @@ gdx parallel open    # Open any fork in your default editor
 gdx parallel join    # Merge changes from a fork back to main
 ```
 
+Additionally, `gdx parallel fork` can auto-initialize submodules and
+install dependencies using detected package managers (currently supports npm, pnpm, bun, and uv)
+if configured (see `parallel.init` config for options),
+getting the fork ready for work in no time.
+
 ### 5. Advanced Stash Management
 
 Git stash is great until you need to clean it up.
@@ -199,17 +212,17 @@ Tools to help you feel productive without leaving the terminal.
 
 ## Command Reference
 
-| Command      | Expansion / Function                                |
-| :----------- | :-------------------------------------------------- |
-| `s`, `stat`  | `git status`                                        |
-| `lg`, `lo`   | `git log --oneline --graph --all --decorate`        |
-| `sw`, `swit` | `git switch`                                        |
-| `br`, `bra`  | `git branch`                                        |
-| `cmi`, `com` | `git commit` (Try `gdx cmi auto` for AI messages!)  |
-| `res`        | `git reset` (supports `res ~3`, `res -h` expansion) |
-| `sta`, `st`  | `git stash`                                         |
-| `lint`       | Run pre-push checks (spelling, secrets, etc.)       |
-| `gdx-config` | Manage gdx configuration                            |
+| Command      | Expansion / Function                                               |
+| :----------- | :----------------------------------------------------------------- |
+| `s`, `stat`  | `git status` (use `-r` recursively run "status" on all submodules) |
+| `lg`, `lo`   | `git log --oneline --graph --all --decorate`                       |
+| `sw`, `swit` | `git switch`                                                       |
+| `br`, `bra`  | `git branch`                                                       |
+| `cmi`, `com` | `git commit` (Try `gdx cmi auto` for AI messages!)                 |
+| `res`        | `git reset` (supports `res ~3`, `res -h` expansion)                |
+| `sta`, `st`  | `git stash`                                                        |
+| `lint`       | Run pre-push checks (spelling, secrets, etc.)                      |
+| `gdx-config` | Manage gdx configuration                                           |
 
 _Run `gdx ghelp` to see the full list of expansions._
 
@@ -235,10 +248,8 @@ This project uses **Bun** for development because it's fast and the developer ex
 
 Since this is currently a solo "scratch your own itch" project, the roadmap is fluid, but here is what is on the horizon:
 
-- [x] **Configurability:** Allow users to define their own shorthands in a `.gdxrc.toml` file.
-- [ ] **Shell Integration:** Auto-completion scripts for Zsh/Bash/Fish/Powershell.
-- [ ] **Commit with specified editor:** like, `gdx commit --vim` to open Vim for commit messages.
-- [ ] **Quick commit:** `add`, `commit`, and `push` in one command like `gdx qc -pa` (`git add . && gdx commit auto && git push`)
+- [x] **Configurability:** Allow users to define their own shorthands in a `.gdxrc.toml` file (default: `~/.gdx/.gdxrc.toml`).
+- [x] **Shell Integration:** Auto-completion scripts for Zsh/Bash/Fish/Powershell with git fallback.
 - [x] **Quick linting before push:** `gdx lint` to run following checks before pushing:
    - commit message spelling
    - env or sensitive content scanning
@@ -246,13 +257,14 @@ Since this is currently a solo "scratch your own itch" project, the roadmap is f
    - abnormal file sizes
      with an option to automatically run lint before every push (bypass with `gdx push --no-lint`)
 - [x] **Undoable stash drop**
-- [x] **Parallel worktree switching** `gdx parallel switch` Jump between forks (auto-cd) (requires shell integration with `gdx --init --shell`)
+- [x] **Parallel worktree switching** `gdx parallel switch` Jump between forks (auto-cd) (requires shell integration with `gdx --init`)
 - [ ] **Seamless Integration with fzf and cloc**
       automatically detect and use fzf and/or cloc if installed for:
    - Interactive fuzzy search for branches, commits, stash, log and files instead of `less`
    - Code line statistics in `gdx stats` using `cloc`
 - [x] **gdx clear Untracked files support**: `gdx clear` now automatically backs up untracked files in the patch.
 - [ ] **gdx migrate**: move dirty changes to another branch/worktree without committing.
+- [x] **Recursive status for submodules** with `gdx status --recursive` or `gdx s -r`
 
 ## License