refactor: providers for terminal operations (#23)

* refactor: providers for terminal operations

* fix: resolve symlink paths in InplaceProvider test for macOS

* docs: update latest info

Author: Stephanvs

docs/configuration.md

@@ -44,7 +44,7 @@ Controls how `hypr` interacts with your terminal.
 
 | Key          | Type    | Default | Description                                                                                                                                                                                                                                                                                                                            |
 | ------------ | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`       | string  | `"tab"` | Determines how `hypr` opens worktrees. <br> • `tab`: Open in a new tab (default). <br> • `window`: Open in a new window. <br> • `inplace`: Switch the current terminal to the worktree directory. <br> • `echo`: Output shell commands to stdout. <br> **ENV**: `HYPR_TERMINAL_MODE` <br> **CLI**: `--terminal <mode>` |
+| `mode`       | string  | `"window"` | Determines how `hypr` opens worktrees. <br> • `window`: Open in a new window (default). <br> • `tab`: Open in a new tab. <br> • `inplace`: Switch the current terminal to the worktree directory. <br> • `echo`: Output shell commands to stdout. <br> **ENV**: `HYPR_TERMINAL_MODE` <br> **CLI**: `--terminal <mode>` |
 | `always_new` | boolean | `false` | If `true`, always creates a new terminal session instead of switching to an existing one for a worktree. <br> **ENV**: `HYPR_TERMINAL_ALWAYS_NEW` <br> **CLI**: `--ignore-same-session`                                                                                                                                              |
 | `program`    | string  | `null`  | Force `hypr` to use a specific terminal program instead of auto-detecting one. <br> _Examples: `iterm2`, `terminal`, `tmux`_ <br> **ENV**: `HYPR_TERMINAL_PROGRAM`                                                                                                                                                                 |
 

docs/gettingstarted.md

@@ -6,15 +6,35 @@ This guide will walk you through installing `hypr`, setting it up for a project,
 
 Before you begin, make sure you have the following installed:
 
--   **Python 3.10+**: You can check your version with `python3 --version`.
--   **Git 2.5+**: `hypr` relies on modern git worktree functionality. Check your version with `git --version`. Git 2.5 was released in 2015, so this shouldn’t be a problem.
+-   **Git 2.5+**: `hypr` relies on modern git worktree functionality. Check your version with `git --version`. Git 2.5 was released in 2015, so this shouldn't be a problem.
 -   **A supported terminal (recommended)**: For the best experience, use a terminal with good tab and window management, like iTerm2 on macOS. See the [Terminal Support](terminalsupport.md) page for more details.
 
 ## Installation
 
-### Pip
+### Homebrew (macOS)
 
-First, `pip install hypr`. To verify the installation, run `hypr` in a git repository to see its status:
+```bash
+brew install stephanvs/tap/hypr
+```
+
+### Scoop (Windows)
+
+```bash
+scoop bucket add hypr https://github.com/Stephanvs/hypr
+scoop install hypr
+```
+
+### AUR (Arch Linux)
+
+```bash
+yay -S hypr-bin
+```
+
+### Manual Download
+
+Download the latest release for your platform from [GitHub Releases](https://github.com/Stephanvs/hypr/releases).
+
+To verify the installation, run `hypr` in a git repository to see its status:
 
 ```txt
   Worktrees:

docs/terminalsupport.md

@@ -2,15 +2,40 @@
 
 ## hypr automates your terminal by default
 
-`hypr`'s intended user experience is that it will open terminal tabs on your behalf. It uses [`automate-terminal`](https://github.com/irskep/automate-terminal) to accomplish this, so check that project out to find out if your terminal is supported.
+`hypr`'s intended user experience is that it will open terminal tabs or windows on your behalf. It natively supports the following terminals:
+
+### macOS
+
+- **iTerm2** - Full tab and window support
+- **Terminal.app** - Full tab and window support
+- **tmux** - When running inside a tmux session
+
+### Windows
+
+- **Windows Terminal** - Full tab and window support
+
+### Linux
+
+- **GNOME Terminal** - Full tab and window support
+- **tmux** - When running inside a tmux session
+
+### All Platforms
+
+- **VS Code** - Opens worktrees in VS Code (`--terminal=vscode`)
+- **Cursor** - Opens worktrees in Cursor (`--terminal=cursor`)
 
 ## What to do if your terminal isn't supported or you don't want this behavior
 
-Add this to your `.hypr.toml` or set it at the user level with `hypr config`:
+Add this to your `.hypr.json` or set it at the user level with `hypr config`:
 
-```
-[terminal]
-mode = 'echo'
+```json
+{
+  "Terminal": {
+    "Mode": "echo"
+  }
+}
 ```
 
 This will cause hypr to print commands to the console instead of having your terminal run them automatically. You can then manually run the printed commands to navigate to the worktree.
+
+Alternatively, use `--terminal=inplace` to have hypr change the current terminal's directory directly.

src/Module.cs

@@ -1,23 +1,73 @@
 using Hypr.Configuration;
 using Hypr.Hooks;
 using Hypr.Services;
+using Hypr.Services.Terminals;
+using Hypr.Utils;
 using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.DependencyInjection;
 
 namespace Hypr;
 
 internal static class Module
 {
-  internal static IServiceCollection AddServices(this IServiceCollection services, IConfiguration configuration) => services
-    .Configure<TerminalConfig>(configuration.GetSection("terminal"))
-    .Configure<WorktreeConfig>(configuration.GetSection("worktree"))
-    .Configure<CleanupConfig>(configuration.GetSection("cleanup"))
-    .Configure<ScriptsConfig>(configuration.GetSection("scripts"))
-    .Configure<ConfirmationsConfig>(configuration.GetSection("confirmations"))
-    .AddSingleton<StateService>()
-    .AddSingleton<GitService>()
-    .AddSingleton<GitHubService>()
-    .AddSingleton<TerminalService>()
-    .AddSingleton<VersionCheckService>()
-    .AddSingleton<HookRunner>();
+    internal static IServiceCollection AddServices(this IServiceCollection services, IConfiguration configuration) => services
+        .Configure<TerminalConfig>(configuration.GetSection("terminal"))
+        .Configure<WorktreeConfig>(configuration.GetSection("worktree"))
+        .Configure<CleanupConfig>(configuration.GetSection("cleanup"))
+        .Configure<ScriptsConfig>(configuration.GetSection("scripts"))
+        .Configure<ConfirmationsConfig>(configuration.GetSection("confirmations"))
+        .AddSingleton<StateService>()
+        .AddSingleton<GitService>()
+        .AddSingleton<GitHubService>()
+        .AddSingleton<TerminalService>()
+        .AddSingleton<VersionCheckService>()
+        .AddSingleton<HookRunner>()
+        .AddTerminalProviders();
+
+    private static IServiceCollection AddTerminalProviders(this IServiceCollection services)
+    {
+        var currentPlatform = GetCurrentPlatform();
+
+        // Use Scrutor to scan and register all terminal providers that support the current platform
+        services.Scan(scan => scan
+            .FromAssemblyOf<ITerminalProvider>()
+            .AddClasses(classes => classes
+                .AssignableTo<ITerminalProvider>()
+                .Where(type => SupportsCurrentPlatform(type, currentPlatform)))
+            .AsImplementedInterfaces()
+            .WithSingletonLifetime());
+
+        return services;
+    }
+
+    private static Platform GetCurrentPlatform()
+    {
+        if (PlatformUtils.IsWindows) return Platform.Windows;
+        if (PlatformUtils.IsMacOS) return Platform.MacOS;
+        if (PlatformUtils.IsLinux) return Platform.Linux;
+        return Platform.None;
+    }
+
+    private static bool SupportsCurrentPlatform(Type providerType, Platform currentPlatform)
+    {
+        return GetSupportedPlatformsForType(providerType).HasFlag(currentPlatform);
+    }
+
+    private static Platform GetSupportedPlatformsForType(Type providerType)
+    {
+        // Map known provider types to their supported platforms
+        return providerType.Name switch
+        {
+            nameof(WindowsTerminalProvider) => Platform.Windows,
+            nameof(ITerm2Provider) => Platform.MacOS,
+            nameof(TerminalAppProvider) => Platform.MacOS,
+            nameof(GnomeTerminalProvider) => Platform.Linux,
+            nameof(TmuxProvider) => Platform.Linux | Platform.MacOS,
+            nameof(VSCodeProvider) => Platform.All,
+            nameof(CursorProvider) => Platform.All,
+            nameof(EchoProvider) => Platform.All,
+            nameof(InplaceProvider) => Platform.All,
+            _ => Platform.None
+        };
+    }
 }