Added shell tab-completion documentation

Author: KevinLang2

docs/en/build-script-runner-interactive.md

@@ -1,6 +1,8 @@
 
 
-When executing flubu script or any other process locally in console it is recomended to run FlubuCore in interactive mode it gives you some really nice features which are listed in the [features section.](#features) To start FlubuCore interactive mode just execute command `flubu -i` in your favorite console. 
+When executing flubu script or any other process locally in console it is recomended to run FlubuCore in interactive mode it gives you some really nice features which are listed in the [features section.](#features) To start FlubuCore interactive mode just execute command `flubu -i` in your favorite console.
+
+> **Tip:** If you prefer standard terminal usage over interactive mode, FlubuCore also supports [shell tab completion](build-script-runner.md#shell-tab-completion) for bash, zsh, PowerShell, and fish.
 
 ## **Demo**
 ![Interactive mode in action](https://raw.githubusercontent.com/flubu-core/flubu.core/master/assets/FlubuCore_Interactive_mode_full.gif)

docs/en/build-script-runner.md

@@ -50,6 +50,45 @@ It displays all tasks with description that will be executed by target. It also
  that you don't need to execute script at the root directory of the project. Meaning if your project is for example located at "c:\_git\myproject" you can execute script inside any subfolder of that location. The location where a 
  .flubu file is found will be used as the "work directory" during a build process, and a correct "work directory" is crucial to use relative paths in our build scripts.
 
+### **Shell tab completion**
+
+FlubuCore supports shell tab completion for target names, options, and script arguments. Once set up, you can type `flubu <tab>` and get completions directly in your terminal — no need to run `flubu help` or switch to interactive mode.
+
+#### Setup
+
+Add one of the following to your shell profile:
+
+**Bash** (~/.bashrc):
+```bash
+eval "$(flubu --setup-completions bash)"
+```
+
+**Zsh** (~/.zshrc):
+```bash
+eval "$(flubu --setup-completions zsh)"
+```
+
+**PowerShell** ($PROFILE):
+```powershell
+flubu --setup-completions pwsh | Invoke-Expression
+```
+
+**Fish** (~/.config/fish/config.fish):
+```fish
+flubu --setup-completions fish | source
+```
+
+#### What completes
+
+| Input | Completes with |
+|-------|---------------|
+| `flubu <tab>` | All target names from your build script |
+| `flubu cl<tab>` | Targets starting with "cl" (e.g. `clean`) |
+| `flubu --<tab>` | Options: `--parallel`, `--dryRun`, `--noColor`, `--nodeps`, `--script`, etc. |
+| `flubu -<tab>` | Script arguments defined with `[FromArg]` attributes |
+
+Completions are dynamic — targets are discovered from your build script on each tab press. When you add a new target and save the file, it appears in completions immediately.
+
 ### **Default build script locations**
 
 - "Build.cs"

docs/en/getting-started.md

@@ -69,6 +69,7 @@ project.json:
 - .net core sdk 2.1.300 or greater must be installed.
 - Install FlubuCore local or global tool: `dotnet tool install --global FlubuCore.Tool`
 - Run `flubu compile` where build script is located. It will compile your solution.
+- Optionally enable [shell tab completion](build-script-runner.md#shell-tab-completion) for target and option completions in your terminal.
 
 This is very basic build script just for you to see how simple it is to get you started. FlubuCore has to offer a lot of nice features. Read more about them at [Build script fundamentals]. 
 You should also take a look at [.net core examples] they will give you hints how to write your build script and see most of the main flubu features in action. 

docs/en/index.md

@@ -186,10 +186,12 @@ public class BuildScript : DefaultBuildScript
 
 * [Possibility to use FlubuCore tasks in any other .NET application.](https://github.com/flubu-core/examples/blob/master/NetCore_csproj/BuildScript/BuildScriptTests.cs)
 
-* [FlubuCore interactive mode](https://flubucore.dotnetcore.xyz/build-script-runner-interactive/) which offers target tab completition, options tab completition, toogle targets/options, executed commands history. It is also possible to execute external commands and operable programs. For some of them FlubuCore offers tab completion with help displayed at the bottom of console out of the box(such as dotnet, git..)  
+* [FlubuCore interactive mode](https://flubucore.dotnetcore.xyz/build-script-runner-interactive/) which offers target tab completition, options tab completition, toogle targets/options, executed commands history. It is also possible to execute external commands and operable programs. For some of them FlubuCore offers tab completion with help displayed at the bottom of console out of the box(such as dotnet, git..)
 
 ![FlubuCore interactive mode](https://raw.githubusercontent.com/dotnetcore/flubu.core/master/assets/FlubuCore_Interactive_mode_full.gif)
 
+* [Shell tab completion](https://flubucore.dotnetcore.xyz/build-script-runner/#shell-tab-completion) for bash, zsh, PowerShell, and fish. Get target and option completions directly in your terminal without entering interactive mode.
+
 * Improved developer experience with FlubuCore custom analyzers.
 
 ![FlubuCore analyzers in action](https://raw.githubusercontent.com/flubu-core/flubu.core/master/assets/FlubuCoreCustomAnalyzerDemo.png)