Bump version to 0.0.5

.devcontainer/alpine-container/devcontainer.json

@@ -0,0 +1,3 @@
+{
+    "image": "mcr.microsoft.com/dotnet/sdk:8.0-alpine"
+}

.devcontainer/debian-container/devcontainer.json

@@ -0,0 +1,3 @@
+{
+    "image": "mcr.microsoft.com/dotnet/sdk:8.0"
+}

.devcontainer/devcontainer.json

@@ -1,3 +0,0 @@
-{
-    "image": "mcr.microsoft.com/dotnet/sdk:7.0-alpine"
-}

.editorconfig

@@ -0,0 +1,2 @@
+[*.cs]
+

.github/workflows/github-actions.yml

@@ -21,12 +21,17 @@ jobs:
             name: linux
             outputname: Alma
             version_script: .scripts/versioning.sh
+          - runtime: linux-musl-x64
+            runner: ubuntu-latest
+            name: linux-musl
+            outputname: Alma
+            version_script: .scripts/versioning.sh
     steps:
       - uses: actions/checkout@v3
       - name: Setup dotnet
         uses: actions/setup-dotnet@v3
         with:
-          dotnet-version: '7.0.x'
+          dotnet-version: '8.0.x'
       - name: Patch version
         run: ${{ matrix.target.version_script }}
         continue-on-error: true
@@ -53,6 +58,11 @@ jobs:
         with:
           name: alma-linux
           path: app/linux/
+      - uses: actions/download-artifact@v3
+        name: Download Linux musl artifacts
+        with:
+          name: alma-linux
+          path: app/linux-musl/
     
       - name: Create release directory
         run: mkdir release
@@ -62,11 +72,13 @@ jobs:
     
       - name: Copy linux executable
         run: cp app/linux/Alma release/alma-linux
+    
+      - name: Copy linux-musl executable
+        run: cp app/linux-musl/Alma release/alma-linux-musl
 
       - uses: "marvinpinto/action-automatic-releases@latest"
         name: Create release
         with:
-          title: Test
           repo_token: "${{ secrets.GITHUB_TOKEN }}"
           automatic_release_tag: latest
           prerelease: false

.scripts/versioning.ps1

@@ -1,5 +1,3 @@
-gci env:\
-
 if((Get-Content env:\GITHUB_REF_TYPE) -ne "tag")
 {
     Return
@@ -11,5 +9,4 @@ $git_sha = (Get-Content env:\GITHUB_SHA).Substring(0, 8)
 Write-Host $version
 Write-Host $git_sha
 
-(Get-Content src\Alma\Alma.csproj).Replace("0.0.0", $version).Replace("development", $git_sha) | Set-Content src\Alma\Alma.csproj
+(Get-Content src\Alma\Alma.csproj).Replace("0.0.0", $version).Replace("development", $git_sha) | Set-Content src\Alma\Alma.csproj
-Write-Host (Get-Content src\Alma\Alma.csproj)

.scripts/versioning.sh

@@ -1,5 +1,3 @@
-printenv
-
 if [ ${GITHUB_REF_TYPE}  != "tag" ]; then
     exit 1
 fi
@@ -12,5 +10,4 @@ git_hash=`expr substr $git_hash 1 8`
 echo $version
 echo $git_hash
 
-sed -i "s/0.0.0/$version/g;s/development/$git_hash/g" src/Alma/Alma.csproj
+sed -i "s/0.0.0/$version/g;s/development/$git_hash/g" src/Alma/Alma.csproj
-cat src/Alma/Alma.csproj

.vscode/launch.json

@@ -10,8 +10,8 @@
             "request": "launch",
             "preLaunchTask": "build",
             // If you have changed target frameworks, make sure to update the program path.
-            "program": "${workspaceFolder}/src/Alma/bin/Debug/net7.0/Alma.dll",
+            "program": "${workspaceFolder}/src/Alma/bin/Debug/net8.0/Alma.dll",
-            "args": [],
+            "args": ["link", "dotconfig", "git", "-d"],
             "cwd": "${workspaceFolder}/src/Alma",
             // For more information about the 'console' field, see https://aka.ms/VSCode-CS-LaunchJson-Console
             "console": "internalConsole",

Dockerfile

@@ -0,0 +1,25 @@
+FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine as BUILD
+
+RUN apk add -U clang zlib-dev
+WORKDIR /build
+COPY . .
+
+RUN dotnet publish src/Alma/Alma.csproj -c Release -r linux-musl-x64 -p:PublishAot=true -o /app
+
+FROM alpine:edge as FINAL
+
+RUN mkdir /data
+WORKDIR /data
+
+ENV ALMA_APP_DATA_FALLBACK=/appdata
+ENV ALMA_CONFIG_FALLBACK=/appconfig
+
+RUN mkdir /appdata
+RUN mkdir /appconfig
+
+RUN apk add -U icu-libs libstdc++
+
+COPY --from=BUILD /app/Alma /alma
+
+ENTRYPOINT ["/alma"]
+CMD ["help"]

README.md

@@ -0,0 +1,32 @@
+ # Alma
+
+Alma (aka Advanced Link Manager Application) is another dotfiles management tool.
+
+## Installation
+
+**Linux**
+
+```
+sudo wget https://github.com/ADIX7/Alma/releases/download/latest/alma-linux -O /usr/local/bin/alma
+sudo chmod +x /usr/local/bin/alma
+```
+
+**Windows**
+
+This PowerShell command will download the alma.exe to the current folder. Move it to a folder that is in PATH.
+```
+Invoke-WebRequest https://github.com/ADIX7/Alma/releases/download/latest/Alma.exe -OutFile alma.exe
+```
+
+**As a Docker tool**
+
+You can run it with Docker/Podman. You should mount every directory (source and target too) to the same path as they are on the host.
+For example, if you have your dotfiles cloned to your home folder and you have your repository.json in ~/.config/alma/repository.json, then you can run this command and the links will be correct on the host.
+```
+docker run --rm -it -v /home/myuser:/home/myuser -e "HOME=/home/myuser" adix7/alma:latest ...
+```
+
+If you don't have repository.json, you can set the WORKDIR (or ALMA_WORKDIR) env var to your repository. For example, if you cloned your dotfiles to ~/dotfiles, you can use this command.
+```
+docker run --rm -it -v /home/myuser:/home/myuser -e "WORKDIR=/home/myuser/dotfiles" adix7/alma:latest ...
+```

src/Alma.Abstraction/Alma.Abstraction.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net7.0</TargetFramework>
+    <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <RootNamespace>Alma</RootNamespace>

src/Alma.Abstraction/Command/ICommand.cs

@@ -2,6 +2,7 @@ namespace Alma.Command;
 
 public interface ICommand
 {
-    public string CommandString { get; }
+    string CommandString { get; }
-    public Task Run(List<string> parameters);
+    string[] CommandAliases { get; }
+    Task Run(List<string> parameters);
 }

src/Alma.Abstraction/Configuration/Module/ModuleConfiguration.cs

@@ -4,14 +4,18 @@ public class ModuleConfiguration
 {
     public string? Target { get; set; }
     public Dictionary<string, string>? Links { get; set; }
+    public List<string>? Exclude { get; set; }
+    public bool ExcludeReadme { get; set; } = true;
 
     public string? Install { get; set; }
+    public string? Configure { get; set; }
 
-    public ModuleConfiguration(string? target, Dictionary<string, string>? links, string? install)
+    public ModuleConfiguration(string? target, Dictionary<string, string>? links, string? install, string? configure)
     {
         Target = target;
         Links = links;
         Install = install;
+        Configure = configure;
     }
 
     public ModuleConfiguration Merge(ModuleConfiguration merge)
@@ -21,10 +25,11 @@ public class ModuleConfiguration
         return new ModuleConfiguration(
             merge.Target ?? Target,
             new Dictionary<string, string>(mergedLinks),
-            merge.Install ?? Install
+            merge.Install ?? Install,
+            merge.Configure ?? Configure
         );
     }
 
     public static ModuleConfiguration Empty() =>
-        new(null, new Dictionary<string, string>(), null);
+        new(null, new Dictionary<string, string>(), null, null);
 }

src/Alma.Abstraction/Data/ColorCodes.cs

@@ -0,0 +1,8 @@
+namespace Alma.Data;
+
+public static class ColorCodes
+{
+    public const string Reset = "\u001b[0m";
+    public const string RedForeground = "\u001b[38;5;1m";
+    public const string GreenForeground = "\u001b[38;5;2m";
+}

src/Alma.Abstraction/Data/ModuleConfigurationWithName.cs

@@ -0,0 +1,5 @@
+using Alma.Configuration.Module;
+
+namespace Alma.Data;
+
+public record ModuleConfigurationWithName(string Name, ModuleConfiguration Configuration);

src/Alma.Abstraction/Data/SpecialPathResolver.cs

@@ -0,0 +1,3 @@
+namespace Alma.Data;
+
+public record SpecialPathResolver(string PathName, Func<string> Resolver, bool? SkipCombiningCurrentDirectory = null);

src/Alma.Abstraction/Services/IPathHelperService.cs

@@ -0,0 +1,6 @@
+namespace Alma.Services;
+
+public interface IPathHelperService
+{
+    string ResolvePath(string path, string? currentDirectory = null);
+}

src/Alma.App/Alma.App.csproj

@@ -6,11 +6,12 @@
   </ItemGroup>
 
   <ItemGroup>
+    <PackageReference Include="LiteDB" Version="5.0.19" />
     <PackageReference Include="System.Linq.Async" Version="6.0.1" />
   </ItemGroup>
 
   <PropertyGroup>
-    <TargetFramework>net7.0</TargetFramework>
+    <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <RootNamespace>Alma</RootNamespace>

src/Alma.App/Application.cs

@@ -1,5 +1,4 @@
 using Alma.Command;
-using Alma.Command.Help;
 using Alma.Logging;
 
 namespace Alma;
@@ -25,7 +24,7 @@ public class Application
 
         var commandString = args[0];
 
-        var command = _commands.FirstOrDefault(c => c.CommandString == commandString);
+        var command = _commands.FirstOrDefault(c => c.CommandString == commandString || c.CommandAliases.Contains(commandString));
 
         if (command is null)
         {

src/Alma.App/Command/Configure/ConfigureCommand.cs

@@ -0,0 +1,63 @@
+using Alma.Command.Install;
+using Alma.Configuration.Repository;
+using Alma.Logging;
+using Alma.Services;
+
+namespace Alma.Command.Configure;
+
+public class ConfigureCommand : RepositoryModuleCommandBase
+{
+    private readonly ILogger<InstallCommand> _logger;
+    private readonly IShellService _shellService;
+    public override string CommandString => "configure";
+    public override string[] CommandAliases => Array.Empty<string>();
+
+    public ConfigureCommand(
+        ILogger<InstallCommand> logger,
+        IRepositoryConfiguration repositoryConfiguration,
+        IModuleConfigurationResolver moduleConfigurationResolver,
+        IShellService shellService,
+        IPathHelperService pathHelperService)
+        : base(repositoryConfiguration, pathHelperService, moduleConfigurationResolver)
+    {
+        _logger = logger;
+        _shellService = shellService;
+    }
+
+    public override async Task Run(List<string> parameters)
+    {
+        var (repoName, moduleName) = GetRepositoryAndModuleName(parameters);
+        if (moduleName is null)
+        {
+            _logger.LogInformation("No module specified");
+            return;
+        }
+        var (moduleConfiguration, _) = await GetModuleConfiguration(repoName, moduleName);
+
+        if (moduleConfiguration is null)
+        {
+            _logger.LogInformation($"No module configuration found for module '{moduleName}'{(repoName is null ? "" : $" in repository '{repoName}'")}");
+            return;
+        }
+
+        var configureLines = moduleConfiguration.Configure?.Split(Environment.NewLine);
+
+        if (configureLines is null)
+        {
+            _logger.LogInformation("No configure command is found");
+            return;
+        }
+
+        _logger.LogInformation($"Configure command: {string.Join("\n", configureLines)}");
+
+        if (configureLines.Length == 1)
+        {
+            _logger.LogInformation("Running configure command '" + configureLines[0] + "'");
+            await _shellService.RunCommandAsync(configureLines[0]);
+        }
+        else
+        {
+            _logger.LogError("Multi line scripts are not currently supported");
+        }
+    }
+}

src/Alma.App/Command/Diag/DiagCommand.cs

@@ -0,0 +1,131 @@
+using System.Reflection;
+using Alma.Logging;
+
+namespace Alma.Command.Diag;
+
+public class DiagCommand : ICommand
+{
+    private readonly ILogger<DiagCommand> _logger;
+    public string CommandString => "diag";
+    public string[] CommandAliases => Array.Empty<string>();
+
+    private readonly Lazy<IReadOnlyList<MethodInfo>> _diagnosticHelpersLazy;
+
+    public DiagCommand(ILogger<DiagCommand> logger)
+    {
+        _logger = logger;
+        _diagnosticHelpersLazy = new Lazy<IReadOnlyList<MethodInfo>>(FindDiagnosticHelpers);
+    }
+
+    public Task Run(List<string> parameters)
+    {
+        if (parameters.Count < 1)
+        {
+            _logger.LogInformation("No diagnostic helper specified.");
+            return Task.CompletedTask;
+        }
+
+        var command = parameters[0];
+
+        if(command == "--help")
+        {
+            _logger.LogInformation(
+                """
+                Usage: 
+                    diag list
+                    diag <diag-helper>
+                """
+            );
+            return Task.CompletedTask;
+        }
+
+        if (command == "list")
+        {
+            ListDiagnosticHelpers();
+            return Task.CompletedTask;
+        }
+
+        var diagnosticHelpers = _diagnosticHelpersLazy.Value;
+
+        var helper = diagnosticHelpers.FirstOrDefault(
+            h => GetDiagnosticHelper(h) is { } attr && attr.Command == command
+        );
+
+        if (helper is null)
+        {
+            _logger.LogInformation($"Diagnostic helper {command} is not found.");
+            return Task.CompletedTask;
+        }
+
+        if (!helper.IsStatic)
+        {
+            _logger.LogInformation($"Diagnostic helper {helper.Name} is not static.");
+            return Task.CompletedTask;
+        }
+
+        HandleHelper(helper, parameters.Skip(1));
+
+        return Task.CompletedTask;
+    }
+
+    private void ListDiagnosticHelpers()
+    {
+        var diagnosticHelpers = _diagnosticHelpersLazy.Value;
+        var commands = diagnosticHelpers
+            .Select(h => GetDiagnosticHelper(h)?.Command)
+            .OfType<string>()
+            .Order()
+            .ToList();
+
+        _logger.LogInformation("Available diagnostic helpers:");
+        foreach (var command in commands)
+        {
+            _logger.LogInformation(command);
+        }
+    }
+
+    private void HandleHelper(MethodInfo helper, IEnumerable<string> parameters)
+    {
+        var helperParameters = helper.GetParameters();
+        var helperArguments = new object[helperParameters.Length];
+        for (var i = 0; i < helperParameters.Length; i++)
+        {
+            var parameterType = helperParameters[i].ParameterType;
+            if (parameterType == typeof(IEnumerable<string>))
+            {
+                helperArguments[i] = parameters;
+            }
+            else if (parameterType == typeof(ILogger))
+            {
+                helperArguments[i] = _logger;
+            }
+            else
+            {
+                _logger.LogInformation($"Diagnostic helper {helper.Name} has wrong parameter type, could not resolve '{parameterType}'.");
+                return;
+            }
+        }
+        
+        helper.Invoke(null, helperArguments);
+    }
+
+    private IReadOnlyList<MethodInfo> FindDiagnosticHelpers()
+    {
+        var assemblies = new[]
+        {
+            Assembly.GetExecutingAssembly(),
+        };
+
+        return assemblies.SelectMany(
+                a =>
+                    a
+                        .GetTypes()
+                        .SelectMany(t => t.GetMethods())
+                        .Where(t => t.GetCustomAttributes(typeof(DiagnosticHelper)).Any()))
+            .ToList()
+            .AsReadOnly();
+    }
+
+    private DiagnosticHelper? GetDiagnosticHelper(MethodInfo o)
+        => o.GetCustomAttributes(typeof(DiagnosticHelper)).FirstOrDefault() as DiagnosticHelper;
+}

src/Alma.App/Command/Diag/DiagnosticHelper.cs

@@ -0,0 +1,12 @@
+namespace Alma.Command.Diag;
+
+[AttributeUsage(AttributeTargets.Method)]
+public class DiagnosticHelper : Attribute
+{
+    public string Command { get; }
+
+    public DiagnosticHelper(string command)
+    {
+        Command = command;
+    }
+}

src/Alma.App/Command/Help/HelpCommand.cs

@@ -9,6 +9,8 @@ public class HelpCommand : ICommand
 
     public string CommandString => "help";
 
+    public string[] CommandAliases { get; } = ["--help", "-h"];
+
     public HelpCommand(
         IServiceProvider serviceProvider,
         ILogger<HelpCommand> logger

src/Alma.App/Command/Info/InfoCommand.cs

@@ -1,39 +1,73 @@
+using Alma.Configuration.Module;
 using Alma.Configuration.Repository;
-using Alma.Helper;
+using Alma.Data;
 using Alma.Logging;
 using Alma.Services;
 
 namespace Alma.Command.Info;
 
-public class InfoCommand : ICommand
+public class InfoCommand : RepositoryModuleCommandBase
 {
-    public string CommandString => "info";
+    public override string CommandString => "info";
+    public override string[] CommandAliases => Array.Empty<string>();
 
     private readonly IFolderService _folderService;
     private readonly IRepositoryConfiguration _repositoryConfiguration;
+    private readonly IModuleConfigurationResolver _moduleConfigurationResolver;
     private readonly ILogger<InfoCommand> _logger;
     private readonly IOsInformation _osInformation;
     private readonly IVersionService _versionService;
+    private readonly IPathHelperService _pathHelperService;
+
+    private static readonly List<Func<ModuleConfiguration, string?>> _moduleInfoDetailResolvers = new()
+    {
+        (m) =>
+        {
+            var linkCount = m.Links?.Count ?? 0;
+            return linkCount.ToString().PadLeft(3) + $" link{(linkCount > 1 ? "s" : "")}".PadRight(6);
+        },
+        (m) => m.Install is not null ? "[Install]" : null,
+        (m) => m.Configure is not null ? "[Configure]" : null,
+    };
 
     public InfoCommand(
         IFolderService folderService,
         IRepositoryConfiguration repositoryConfiguration,
+        IModuleConfigurationResolver moduleConfigurationResolver,
         ILogger<InfoCommand> logger,
         IOsInformation osInformation,
-        IVersionService versionService
+        IVersionService versionService,
-    )
+        IPathHelperService pathHelperService
+    ) : base(repositoryConfiguration, pathHelperService, moduleConfigurationResolver)
     {
         _folderService = folderService;
         _repositoryConfiguration = repositoryConfiguration;
+        _moduleConfigurationResolver = moduleConfigurationResolver;
         _logger = logger;
         _osInformation = osInformation;
         _versionService = versionService;
+        _pathHelperService = pathHelperService;
     }
 
-    public async Task Run(List<string> parameters)
+    public override async Task Run(List<string> parameters)
+    {
+        var (repoName, moduleName) = GetRepositoryAndModuleName(parameters, true);
+        if (repoName is not null && moduleName is null)
+        {
+            await ProcessRepoInfoAsync(repoName);
+        }
+        else if (repoName is not null && moduleName is not null)
+        {
+            await ProcessModuleInfoAsync(repoName, moduleName);
+        }
+        else
+        {
+            await ProcessGeneralInfoAsync();
+        }
+    }
+
+    private async Task ProcessGeneralInfoAsync()
     {
-        //Add info REPO
-        //Add info REPO MODULE
         _logger.LogInformation("Alma " + _versionService.GetVersion());
         _logger.LogInformation("");
 
@@ -53,16 +87,17 @@ public class InfoCommand : ICommand
         _logger.LogInformation($"Platform is '{await _osInformation.GetOsIdentifierAsync()}'");
         _logger.LogInformation("");
 
-        if (_repositoryConfiguration.Configuration.Repositories is {Count: > 0} repositories)
+        if (_repositoryConfiguration.Configuration.Repositories is { Count: > 0 } repositories)
         {
             _logger.LogInformation("Repositories:");
             foreach (var repository in repositories)
             {
                 Console.Write(repository.Name);
-                if (repository.RepositoryPath is not null && !Directory.Exists(PathHelper.ResolvePath(repository.RepositoryPath)))
+                if (repository.RepositoryPath is not null && !Directory.Exists(_pathHelperService.ResolvePath(repository.RepositoryPath)))
                 {
                     Console.Write($" (containing folder not exists {repository.RepositoryPath})");
                 }
+
                 _logger.LogInformation("");
             }
         }
@@ -71,4 +106,111 @@ public class InfoCommand : ICommand
             _logger.LogInformation("No repositories found");
         }
     }
-}
+
+    private async Task ProcessRepoInfoAsync(string repoName)
+    {
+        var (repoSourceDirectory, _) = GetRepositorySourceAndTargetDirectory(repoName);
+
+        var repoRoot = new DirectoryInfo(repoSourceDirectory);
+        var modules = (await TraverseRepoFolder(repoRoot, repoRoot)).OrderBy(e => e.Name).ToList();
+
+        var maxNameLength = modules.Max(m => m.Name.Length);
+
+        _logger.LogInformation($"Repository '{repoName}' contains {modules.Count} modules:");
+        _logger.LogInformation("");
+
+        foreach (var module in modules)
+        {
+            var moduleDetails = _moduleInfoDetailResolvers
+                .Select(m => m(module.Configuration))
+                .Where(m => m is not null)
+                .ToList();
+            _logger.LogInformation($"{module.Name.PadRight(maxNameLength + 3)} {string.Join("    ", moduleDetails)}");
+        }
+    }
+
+    async Task<IEnumerable<ModuleConfigurationWithName>> TraverseRepoFolder(DirectoryInfo repoRoot, DirectoryInfo currentDirectory)
+    {
+        var modulesFound = Enumerable.Empty<ModuleConfigurationWithName>();
+
+        var moduleConfigFileStub = Path.Combine(currentDirectory.FullName, Constants.ModuleConfigFileStub);
+        var (moduleConfig, _) = await _moduleConfigurationResolver.ResolveModuleConfiguration(moduleConfigFileStub);
+
+        if (moduleConfig is not null)
+        {
+            var moduleName = currentDirectory.FullName[(repoRoot.FullName.TrimEnd(Path.DirectorySeparatorChar).Length + 1)..].Replace(Path.DirectorySeparatorChar, '/');
+            modulesFound = modulesFound.Append(new(moduleName, moduleConfig));
+        }
+
+        foreach (var subDir in currentDirectory.GetDirectories())
+        {
+            modulesFound = modulesFound.Concat(await TraverseRepoFolder(repoRoot, subDir));
+        }
+
+        return modulesFound;
+    }
+
+    async Task ProcessModuleInfoAsync(string repoName, string moduleName)
+    {
+        var (moduleConfiguration, moduleConfigFileName) = await GetModuleConfiguration(repoName, moduleName);
+
+        if (moduleConfiguration is null)
+        {
+            _logger.LogInformation($"No configuration is found for module '{moduleName}' in repository '{repoName}':");
+            return;
+        }
+
+        _logger.LogInformation($"Information about module '{moduleName}' in repository '{repoName}':");
+        _logger.LogInformation("");
+
+        var moduleTargetPath = moduleConfiguration.Target is not null
+            ? _pathHelperService.ResolvePath(moduleConfiguration.Target)
+            : null;
+
+        if (moduleTargetPath is not null)
+        {
+            _logger.LogInformation($"Target directory is: {moduleTargetPath}");
+            _logger.LogInformation("");
+        }
+
+        if (moduleConfiguration.Install is not null)
+        {
+            _logger.LogInformation("Can be installed.");
+        }
+
+        if (moduleConfiguration.Configure is not null)
+        {
+            _logger.LogInformation("Can be configured.");
+        }
+
+        if (moduleConfiguration.Links is { } links && links.Count != 0)
+        {
+            var linkCount = links.Count;
+            _logger.LogInformation("");
+            _logger.LogInformation($"Has {linkCount} link{(linkCount > 1 ? "s" : "")}:");
+            _logger.LogInformation("");
+
+            foreach (var link in links)
+            {
+                var sourcePath = Path.Combine(new FileInfo(moduleConfigFileName!).Directory!.FullName, link.Key);
+                var sourceExists = File.Exists(sourcePath) || Directory.Exists(sourcePath);
+                var sourceColor = sourceExists ? ColorCodes.GreenForeground : ColorCodes.RedForeground;
+
+                var targetColor = ColorCodes.RedForeground;
+                if (moduleTargetPath is not null)
+                {
+                    var targetPath = Path.Combine(moduleTargetPath, link.Key);
+                    var targetExists = File.Exists(targetPath) || Directory.Exists(targetPath);
+
+                    targetColor = targetExists ? ColorCodes.GreenForeground : ColorCodes.RedForeground;
+                }
+
+                _logger.LogInformation($"{sourceColor}{link.Key}{ColorCodes.Reset} -> {targetColor}{link.Value}");
+            }
+        }
+        else
+        {
+            _logger.LogInformation("Has no links.");
+        }
+    }
+}

src/Alma.App/Command/Install/InstallCommand.cs

@@ -1,6 +1,4 @@
-using System.Diagnostics;
 using Alma.Configuration.Repository;
-using Alma.Data;
 using Alma.Logging;
 using Alma.Services;
 
@@ -9,19 +7,19 @@ namespace Alma.Command.Install;
 public class InstallCommand : RepositoryModuleCommandBase
 {
     private readonly ILogger<InstallCommand> _logger;
-    private readonly IModuleConfigurationResolver _moduleConfigurationResolver;
     private readonly IShellService _shellService;
     public override string CommandString => "install";
+    public override string[] CommandAliases => Array.Empty<string>();
 
     public InstallCommand(
         ILogger<InstallCommand> logger,
         IRepositoryConfiguration repositoryConfiguration,
         IModuleConfigurationResolver moduleConfigurationResolver,
-        IShellService shellService)
+        IShellService shellService,
-        : base(repositoryConfiguration)
+        IPathHelperService pathHelperService)
+        : base(repositoryConfiguration, pathHelperService, moduleConfigurationResolver)
     {
         _logger = logger;
-        _moduleConfigurationResolver = moduleConfigurationResolver;
         _shellService = shellService;
     }
 
@@ -33,17 +31,7 @@ public class InstallCommand : RepositoryModuleCommandBase
             _logger.LogInformation("No module specified");
             return;
         }
-
+        var (moduleConfiguration, _) = await GetModuleConfiguration(repoName, moduleName);
-        string sourceDirectory = Path.Combine(Environment.CurrentDirectory);
-        string targetDirectory = Path.Combine(Environment.CurrentDirectory, "..");
-
-        string moduleNameAsPath = moduleName.Replace('/', Path.DirectorySeparatorChar);
-        (sourceDirectory, _) = GetModuleSourceAndTargetDirectory(repoName, sourceDirectory, targetDirectory);
-
-        string moduleDirectory = Path.Combine(sourceDirectory, moduleNameAsPath);
-
-        var moduleConfigFileStub = Path.Combine(moduleDirectory, Constants.ModuleConfigFileStub);
-        var (moduleConfiguration, moduleConfigurationFile) = await _moduleConfigurationResolver.ResolveModuleConfiguration(moduleConfigFileStub);
 
         if (moduleConfiguration is null)
         {

src/Alma.App/Command/Link/LinkCommand.cs

@@ -2,8 +2,8 @@ using System.Runtime.InteropServices;
 using Alma.Configuration.Module;
 using Alma.Configuration.Repository;
 using Alma.Data;
-using Alma.Helper;
 using Alma.Logging;
+using Alma.Models;
 using Alma.Services;
 
 namespace Alma.Command.Link;
@@ -13,25 +13,47 @@ public class LinkCommand : RepositoryModuleCommandBase
     private readonly IRepositoryConfiguration _repositoryConfiguration;
     private readonly IModuleConfigurationResolver _moduleConfigurationResolver;
     private readonly IMetadataHandler _metadataHandler;
+    private readonly IPathHelperService _pathHelperService;
     private readonly ILogger<LinkCommand> _logger;
 
     public override string CommandString => "link";
+    public override string[] CommandAliases => Array.Empty<string>();
 
     public LinkCommand(
         IRepositoryConfiguration repositoryConfiguration,
         IModuleConfigurationResolver moduleConfigurationResolver,
         IMetadataHandler metadataHandler,
+        IPathHelperService pathHelperService,
         ILogger<LinkCommand> logger)
-        : base(repositoryConfiguration)
+        : base(repositoryConfiguration, pathHelperService, moduleConfigurationResolver)
     {
         _repositoryConfiguration = repositoryConfiguration;
         _moduleConfigurationResolver = moduleConfigurationResolver;
         _metadataHandler = metadataHandler;
+        _pathHelperService = pathHelperService;
         _logger = logger;
     }
 
     public override async Task Run(List<string> parameters)
     {
+        if (parameters.Contains("--help"))
+        {
+            _logger.LogInformation(
+                """
+                Usage:                
+                    alma link [module]
+                    alma link [repository] [module]
+
+                Options:
+                    --help          Show this message
+                    -d, --dry-run   Show what would be linked without actually linking
+                """
+            );
+            return;
+        }
+
+        var dryRun = parameters.Contains("-d") || parameters.Contains("--dry-run");
+
         var (repoName, moduleName) = GetRepositoryAndModuleName(parameters);
         if (moduleName is null)
         {
@@ -39,10 +61,7 @@ public class LinkCommand : RepositoryModuleCommandBase
             return;
         }
 
-        string sourceDirectory = Path.Combine(Environment.CurrentDirectory);
+        var (sourceDirectory, targetDirectory) = GetRepositorySourceAndTargetDirectory(repoName);
-        string targetDirectory = Path.Combine(Environment.CurrentDirectory, "..");
-
-        (sourceDirectory, targetDirectory) = GetModuleSourceAndTargetDirectory(repoName, sourceDirectory, targetDirectory);
 
         if (!Directory.Exists(sourceDirectory))
         {
@@ -64,7 +83,7 @@ public class LinkCommand : RepositoryModuleCommandBase
 
         if (moduleConfiguration?.Target is string moduleTargetDir)
         {
-            targetDirectory = PathHelper.ResolvePath(moduleTargetDir, targetDirectory);
+            targetDirectory = _pathHelperService.ResolvePath(moduleTargetDir, targetDirectory);
         }
 
         if (!Directory.Exists(targetDirectory))
@@ -82,14 +101,46 @@ public class LinkCommand : RepositoryModuleCommandBase
             moduleDir,
             currentTargetDirectory,
             moduleConfiguration)).ToList();
+
+        // Exclude
         if (moduleConfigurationFile is not null) itemsToLink.RemoveAll(i => i.SourcePath == moduleConfigurationFileFullPath);
 
-        var successfulLinks = CreateLinks(itemsToLink);
+        if (moduleConfiguration?.Exclude is { } excludeList)
+        {
+            foreach (var itemToExclude in excludeList)
+            {
+                var excludePath = Path.Combine(moduleDirectory, Path.Combine(itemToExclude.Split('/')));
+                itemsToLink.RemoveAll(
+                    i => i.SourcePath == excludePath
+                    || i.SourcePath.StartsWith(excludePath + Path.DirectorySeparatorChar)
+                );
+            }
+        }
+
+        if (moduleConfiguration?.ExcludeReadme ?? false)
+        {
+            foreach (var readmeFile in Enum.GetValues<ReadmeFiles>())
+            {
+                var readmeFilePath = Path.Combine(moduleDirectory, readmeFile.GetFileName());
+                itemsToLink.RemoveAll(i => i.SourcePath == readmeFilePath);
+            }
+        }
+
+        // Linking
+
+        if (dryRun)
+        {
+            _logger.LogInformation("Dry run. No links will be created. The following links would be created:");
+        }
+
+        var successfulLinks = CreateLinks(itemsToLink, dryRun);
+
+        if (dryRun) return;
 
         await _metadataHandler.SaveLinkedItemsAsync(successfulLinks, moduleDir, currentTargetDirectory);
     }
 
-    private List<ItemToLink> CreateLinks(List<ItemToLink> itemsToLink)
+    private List<ItemToLink> CreateLinks(List<ItemToLink> itemsToLink, bool dryRun)
     {
         var successfulLinks = new List<ItemToLink>();
 
@@ -108,18 +159,21 @@ public class LinkCommand : RepositoryModuleCommandBase
 
                 _logger.LogInformation($"Linking: '{itemToLink.SourcePath}' '{itemToLink.TargetPath}'");
 
-                if (sourceFileExists)
+                if (!dryRun)
                 {
-                    File.CreateSymbolicLink(itemToLink.TargetPath, itemToLink.SourcePath);
+                    if (sourceFileExists)
-                }
+                    {
-                else if (sourceDirectoryExists)
+                        File.CreateSymbolicLink(itemToLink.TargetPath, itemToLink.SourcePath);
-                {
+                    }
-                    Directory.CreateSymbolicLink(itemToLink.TargetPath, itemToLink.SourcePath);
+                    else if (sourceDirectoryExists)
-                }
+                    {
-                else
+                        Directory.CreateSymbolicLink(itemToLink.TargetPath, itemToLink.SourcePath);
-                {
+                    }
-                    _logger.LogInformation("Source not exists: " + itemToLink.SourcePath);
+                    else
-                    continue;
+                    {
+                        _logger.LogInformation("Source not exists: " + itemToLink.SourcePath);
+                        continue;
+                    }
                 }
 
                 successfulLinks.Add(itemToLink);
@@ -130,7 +184,7 @@ public class LinkCommand : RepositoryModuleCommandBase
             _logger.LogInformation("An error occured while creating links: " + e.Message);
             if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
             {
-                _logger.LogInformation("On Windows symlinks can be greated only with Administrator privileges.");
+                _logger.LogInformation("On Windows symlinks can be created only with Administrator privileges.");
             }
         }
 
@@ -147,7 +201,14 @@ public class LinkCommand : RepositoryModuleCommandBase
         var filesToLink = new List<ItemToLink>();
         foreach (var file in currentDirectory.GetFiles())
         {
-            filesToLink.Add(new ItemToLink(Path.Combine(currentDirectory.FullName, file.Name), Path.Combine(currentTargetDirectory.FullName, file.Name)));
+            if (moduleConfiguration?.Links?.ContainsKey(file.Name) ?? false)
+            {
+                filesToLink.Add(new ItemToLink(file.FullName, _pathHelperService.ResolvePath(moduleConfiguration.Links[file.Name], targetDirectory.FullName)));
+            }
+            else
+            {
+                filesToLink.Add(new ItemToLink(file.FullName, Path.Combine(currentTargetDirectory.FullName, file.Name)));
+            }
         }
 
         var subDirLinksToAdd = Enumerable.Empty<ItemToLink>();
@@ -157,7 +218,7 @@ public class LinkCommand : RepositoryModuleCommandBase
             var relativePath = GetRelativePath(subDir.FullName, moduleDirectory.FullName);
             if (moduleConfiguration?.Links?.ContainsKey(relativePath) ?? false)
             {
-                filesToLink.Add(new ItemToLink(subDir.FullName, PathHelper.ResolvePath(moduleConfiguration.Links[relativePath], targetDirectory.FullName)));
+                filesToLink.Add(new ItemToLink(subDir.FullName, _pathHelperService.ResolvePath(moduleConfiguration.Links[relativePath], targetDirectory.FullName)));
             }
             else
             {

src/Alma.App/Command/List/ListCommand.cs

@@ -12,6 +12,7 @@ public class ListCommand : ICommand
     private readonly ILogger<ListCommand> _logger;
 
     public string CommandString => "ls";
+    public string[] CommandAliases => Array.Empty<string>();
 
     public ListCommand(
         IRepositoryConfiguration repositoryConfiguration,

src/Alma.App/Command/ReadMe/ReadMeCommand.cs

@@ -0,0 +1,92 @@
+
+
+using Alma.Command.Install;
+using Alma.Configuration.Repository;
+using Alma.Logging;
+using Alma.Models;
+using Alma.Services;
+
+namespace Alma.Command.List;
+
+public class ReadMeCommand : RepositoryModuleCommandBase
+{
+    private ILogger<InstallCommand> _logger;
+
+    public override string CommandString => "readme";
+
+    public override string[] CommandAliases => Array.Empty<string>();
+
+    private readonly Dictionary<ReadmeFiles, Func<string, Task>> _readmeFilePrinters;
+
+    public ReadMeCommand(
+        ILogger<InstallCommand> logger,
+        IRepositoryConfiguration repositoryConfiguration,
+        IModuleConfigurationResolver moduleConfigurationResolver,
+        IPathHelperService pathHelperService)
+        : base(repositoryConfiguration, pathHelperService, moduleConfigurationResolver)
+    {
+        _logger = logger;
+
+        _readmeFilePrinters = new Dictionary<ReadmeFiles, Func<string, Task>>
+        {
+            { ReadmeFiles.Markdown, PrintReadMeMd },
+            { ReadmeFiles.Text, PrintReadMeText },
+            { ReadmeFiles.NoExtension, PrintReadMeText },
+        };
+    }
+
+    public override async Task Run(List<string> parameters)
+    {
+        var (repoName, moduleName) = GetRepositoryAndModuleName(parameters);
+        if (moduleName is null)
+        {
+            _logger.LogInformation("No module specified");
+            return;
+        }
+
+        var (repoSource, _) = GetRepositorySourceAndTargetDirectory(repoName);
+        if (repoSource is null)
+        {
+            _logger.LogInformation("No repository source found");
+            return;
+        }
+
+        var fileFound = false;
+
+        foreach (var readmeFile in _readmeFilePrinters.Keys)
+        {
+            // TODO: make this case insensitive
+            var readmeFilePath = Path.Combine(repoSource, moduleName, readmeFile.ToString());
+            if (File.Exists(readmeFilePath))
+            {
+                fileFound = true;
+                await _readmeFilePrinters[readmeFile](readmeFilePath);
+                break;
+            }
+        }
+
+        if (!fileFound)
+        {
+            _logger.LogInformation("No README file found. Supported formats: README.md, README.txt, README");
+        }
+    }
+
+    private async Task PrintReadMeMd(string filePath)
+    {
+        var content = await File.ReadAllLinesAsync(filePath);
+        foreach (var line in content)
+        {
+            //TODO: Add support for markdown
+            _logger.LogInformation(line);
+        }
+    }
+
+    private async Task PrintReadMeText(string filePath)
+    {
+        var content = await File.ReadAllLinesAsync(filePath);
+        foreach (var line in content)
+        {
+            _logger.LogInformation(line);
+        }
+    }
+}

src/Alma.App/Command/RepositoryModuleCommandBase.cs

@@ -1,28 +1,58 @@
 using Alma.Configuration.Repository;
-using Alma.Helper;
+using Alma.Data;
+using Alma.Services;
 
 namespace Alma.Command;
 
 public abstract class RepositoryModuleCommandBase : ICommand
 {
     private readonly IRepositoryConfiguration _repositoryConfiguration;
+    private readonly IModuleConfigurationResolver _moduleConfigurationResolver;
+    private readonly IPathHelperService _pathHelperService;
     public abstract string CommandString { get; }
+    public abstract string[] CommandAliases { get; }
+
     public abstract Task Run(List<string> parameters);
 
-    protected RepositoryModuleCommandBase(IRepositoryConfiguration repositoryConfiguration)
+    protected RepositoryModuleCommandBase(
+        IRepositoryConfiguration repositoryConfiguration,
+        IPathHelperService pathHelperService,
+        IModuleConfigurationResolver moduleConfigurationResolver)
     {
         _repositoryConfiguration = repositoryConfiguration;
+        _pathHelperService = pathHelperService;
+        _moduleConfigurationResolver = moduleConfigurationResolver;
     }
 
-    protected (string?, string?) GetRepositoryAndModuleName(List<string> parameters)
+    protected async Task<(Configuration.Module.ModuleConfiguration? mergedModuleConfig, string? moduleConfigFileName)> GetModuleConfiguration(string? repoName, string moduleName)
+    {
+        var (repoSourceDirectory, _) = GetRepositorySourceAndTargetDirectory(repoName);
+
+        var moduleNameAsPath = moduleName.Replace('/', Path.DirectorySeparatorChar);
+        var moduleDirectory = Path.Combine(repoSourceDirectory, moduleNameAsPath);
+
+        var moduleConfigFileStub = Path.Combine(moduleDirectory, Constants.ModuleConfigFileStub);
+        return await _moduleConfigurationResolver.ResolveModuleConfiguration(moduleConfigFileStub);
+    }
+
+    protected (string? repoName, string? moduleName) GetRepositoryAndModuleName(List<string> parameters, bool singleParamIsRepo = false)
     {
         //TODO: handle parameters
         string? repositoryName = null;
         string? moduleName = null;
 
+        parameters = parameters.Where(p => !p.StartsWith("-")).ToList();
+
         if (parameters.Count == 1)
         {
-            moduleName = parameters[0];
+            if (singleParamIsRepo)
+            {
+                repositoryName = parameters[0];
+            }
+            else
+            {
+                moduleName = parameters[0];
+            }
         }
         else if (parameters.Count >= 1)
         {
@@ -33,18 +63,24 @@ public abstract class RepositoryModuleCommandBase : ICommand
         return (repositoryName, moduleName);
     }
 
-    protected (string sourceDirectory, string targetDirectory) GetModuleSourceAndTargetDirectory(string? repoName, string fallbackSourceDirectory, string fallbackTargetDirectory)
+    protected (string repoSourceDirectory, string repoTargetDirectory) GetRepositorySourceAndTargetDirectory(string? repoName)
+    {
+        string repoSourceDirectory = Path.Combine(Environment.CurrentDirectory);
+        string repoTargetDirectory = Path.Combine(Environment.CurrentDirectory, "..");
+        return GetRepositorySourceAndTargetDirectory(repoName, repoSourceDirectory, repoTargetDirectory);
+    }
+    protected (string repoSourceDirectory, string repoTargetDirectory) GetRepositorySourceAndTargetDirectory(string? repoName, string fallbackSourceDirectory, string fallbackTargetDirectory)
     {
         if (repoName is not null
-            && _repositoryConfiguration.Configuration.Repositories.FirstOrDefault(r => r.Name == repoName) is { } repoConfig)
+            && _repositoryConfiguration.Configuration.Repositories.Find(r => r.Name == repoName) is { } repoConfig)
         {
             fallbackSourceDirectory =
                 repoConfig.RepositoryPath is { } repoPath
-                    ? PathHelper.ResolvePath(repoPath)
+                    ? _pathHelperService.ResolvePath(repoPath)
                     : fallbackSourceDirectory;
             fallbackTargetDirectory =
                 repoConfig.LinkPath is { } linkPath
-                    ? PathHelper.ResolvePath(linkPath)
+                    ? _pathHelperService.ResolvePath(linkPath)
                     : fallbackTargetDirectory;
         }
 

src/Alma.App/Command/Unlink/UnlinkCommand.cs

@@ -3,6 +3,7 @@ namespace Alma.Command.Unlink;
 public class UnlinkCommand : ICommand
 {
     public string CommandString => "unlink";
+    public string[] CommandAliases => Array.Empty<string>();
     public Task Run(List<string> parameters)
     {
         throw new NotImplementedException();

src/Alma.App/Helper/PathHelper.cs

@@ -1,21 +0,0 @@
-namespace Alma.Helper;
-
-public static class PathHelper
-{
-    public static string ResolvePath(string path, string? currentDirectory = null)
-    {
-        var skipCombiningCurrentDirectory = false;
-        if (path.StartsWith("~"))
-        {
-            var userProfile = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);
-            path = path.Length > 1 ? Path.Combine(userProfile, path[2..]) : userProfile;
-            skipCombiningCurrentDirectory = true;
-        }
-
-        //TODO: more special character
-
-        return currentDirectory is null || skipCombiningCurrentDirectory
-            ? path
-            : Path.Combine(currentDirectory, path);
-    }
-}

src/Alma.App/Models/ReadmeFiles.cs

@@ -0,0 +1,20 @@
+namespace Alma.Models;
+
+public enum ReadmeFiles
+{
+    Markdown,
+    Text,
+    NoExtension
+}
+
+public static class ReadmeFileTypeExtensions
+{
+    public static string GetFileName(this ReadmeFiles type)
+        => type switch
+        {
+            ReadmeFiles.Markdown => "README.md",
+            ReadmeFiles.Text => "README.txt",
+            ReadmeFiles.NoExtension => "README",
+            _ => throw new ArgumentOutOfRangeException(nameof(type), type, null)
+        };
+}

src/Alma.App/Services/ConfigurationFileReader.cs

@@ -19,7 +19,14 @@ public class ConfigurationFileReader
     {
         foreach (var configurationFileReader in _configurationFileReaders)
         {
-            if (await configurationFileReader.DeserializeAsync<T>(fileNameWithoutExtension, contextGenerator, extension) is { Result: { } } result) return result;
+            if (await configurationFileReader.DeserializeAsync<T>(
+                fileNameWithoutExtension,
+                contextGenerator,
+                extension) is { Result: { } } result
+            )
+            {
+                return result;
+            }
         }
 
         return (null, null);

src/Alma.App/Services/FolderService.cs

@@ -1,47 +1,70 @@
+using System.Diagnostics.CodeAnalysis;
+using Alma.Command.Diag;
+using Alma.Logging;
+
 namespace Alma.Services;
 
 public class FolderService : IFolderService
 {
+    private readonly Dictionary<string, Func<string?>> _configHomeProviders;
+    private readonly Dictionary<string, Func<string?>> _appDataProviders;
     public string? ConfigRoot { get; }
     public string AppData { get; }
 
     public string ApplicationSubfolderName => "alma";
 
+    [DynamicDependency(DynamicallyAccessedMemberTypes.All, typeof(FolderService))]
     public FolderService()
     {
+        _configHomeProviders = ConfigHomeProviders();
+        _appDataProviders = AppDataProviders();
+
         ConfigRoot = GetConfigHomePath();
         AppData = GetAppDataPath();
 
         if (!Directory.Exists(AppData)) Directory.CreateDirectory(AppData);
     }
 
-    public string GetPreferredConfigurationFolder()
+    private static Dictionary<string, Func<string?>> ConfigHomeProviders()
+    {
+        return new Dictionary<string, Func<string?>>
+        {
+            {"ALMA_CONFIG", () => Environment.GetEnvironmentVariable("ALMA_CONFIG")},
+            {"XDG_CONFIG_HOME", () => Environment.GetEnvironmentVariable("XDG_CONFIG_HOME")},
+            {"UserProfile", GetPreferredConfigurationFolder},
+            {"ALMA_CONFIG_FALLBACK", () => Environment.GetEnvironmentVariable("ALMA_CONFIG_FALLBACK")},
+        };
+    }
+
+    private static Dictionary<string, Func<string?>> AppDataProviders()
+    {
+        return new Dictionary<string, Func<string?>>
+        {
+            {"ALMA_APP_DATA", () => Environment.GetEnvironmentVariable("ALMA_APP_DATA")},
+            {"LocalApplicationData", () => Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData)},
+            {"ALMA_APP_DATA_FALLBACK", () => Environment.GetEnvironmentVariable("ALMA_APP_DATA_FALLBACK")},
+        };
+    }
+
+    string IFolderService.GetPreferredConfigurationFolder()
+        => GetPreferredConfigurationFolder();
+
+    public static string GetPreferredConfigurationFolder()
         => Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), ".config");
 
     private string? GetConfigHomePath()
     {
-        var configHomeProviders = new List<Func<string?>>
+        var configHome = EnumerateProviders(_configHomeProviders.Values);
-        {
-            () => Environment.GetEnvironmentVariable("XDG_CONFIG_HOME"),
-            () => GetPreferredConfigurationFolder()
-        };
-
-        var configHome = EnumerateProviders(configHomeProviders);
         return configHome == null ? null : Path.Combine(configHome, ApplicationSubfolderName);
     }
 
     private string GetAppDataPath()
     {
-        var appDataProviders = new List<Func<string?>>
+        var appData = EnumerateProviders(_appDataProviders.Values) ?? Environment.CurrentDirectory;
-        {
-            () => Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData)
-        };
-
-        var appData = EnumerateProviders(appDataProviders) ?? Environment.CurrentDirectory;
         return Path.Combine(appData, ApplicationSubfolderName);
     }
 
-    private static string? EnumerateProviders(List<Func<string?>> providers)
+    private static string? EnumerateProviders(IEnumerable<Func<string?>> providers)
     {
         string? result = null;
 
@@ -53,4 +76,26 @@ public class FolderService : IFolderService
 
         return result;
     }
+
+    [DiagnosticHelper("config-home-providers")]
+    public static void ConfigHomeProviderDiag(ILogger logger)
+    {
+        var configHomeProviders = ConfigHomeProviders();
+        logger.LogInformation($"There are {configHomeProviders.Count} config home providers:");
+        foreach (var configHome in configHomeProviders)
+        {
+            logger.LogInformation($"{configHome.Key} => {configHome.Value() ?? "<null>"}");
+        }
+    }
+
+    [DiagnosticHelper("app-data-providers")]
+    public static void AppDataProviderDiag(ILogger logger)
+    {
+        var appDataProviders = AppDataProviders();
+        logger.LogInformation($"There are {appDataProviders.Count} app data providers:");
+        foreach (var appData in appDataProviders)
+        {
+            logger.LogInformation($"{appData.Key} => {appData.Value() ?? "<null>"}");
+        }
+    }
 }

src/Alma.App/Services/JsonConfigurationFileReader.cs

@@ -17,6 +17,12 @@ public class JsonConfigurationFileReader : IConfigurationFileReader
         if (!File.Exists(fileName)) return (null, null);
 
         await using FileStream openStream = File.OpenRead(fileName);
-        return ((T?)await JsonSerializer.DeserializeAsync(openStream, typeof(T), contextGenerator(new JsonSerializerOptions(DefaultOptions))), fileName);
+        var result = 
+            (T?)await JsonSerializer.DeserializeAsync(
+                openStream,
+                typeof(T),
+                contextGenerator(new JsonSerializerOptions(DefaultOptions))
+            );
+        return (result, fileName);
     }
 }

src/Alma.App/Services/ModuleConfigurationResolver.cs

@@ -29,6 +29,11 @@ public class ModuleConfigurationResolver : IModuleConfigurationResolver
         //TODO: priority order
         var orderedValidModuleConfigurations = new Dictionary<string, ModuleConfiguration>(validModuleConfigurations);
 
+        if (orderedValidModuleConfigurations.Count == 0)
+        {
+            return (ModuleConfiguration.Empty(), moduleConfigFileName);
+        }
+
         var mergedModuleConfig = orderedValidModuleConfigurations
             .Select(m => m.Value)
             .Aggregate((a, b) => a.Merge(b));

src/Alma.App/Services/PathHelperService.cs

@@ -0,0 +1,47 @@
+using System.Diagnostics.CodeAnalysis;
+using Alma.Command.Diag;
+using Alma.Data;
+using Alma.Logging;
+
+namespace Alma.Services;
+
+public class PathHelperService : IPathHelperService
+{
+    private static readonly List<SpecialPathResolver> _specialPathResolvers = new()
+    {
+        new("~", () => Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), true),
+        new("%DOCUMENTS%", () => Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)),
+    };
+
+    [DynamicDependency(DynamicallyAccessedMemberTypes.All, typeof(PathHelperService))]
+    public string ResolvePath(string path, string? currentDirectory = null)
+    {
+        var skipCombiningCurrentDirectory = false;
+
+        foreach (var specialPathResolver in _specialPathResolvers)
+        {
+            if (path.Contains(specialPathResolver.PathName))
+            {
+                var parts = path.Split(specialPathResolver.PathName);
+                path = string.Join(specialPathResolver.Resolver(), parts);
+                skipCombiningCurrentDirectory = (specialPathResolver.SkipCombiningCurrentDirectory ?? false) || skipCombiningCurrentDirectory;
+            }
+        }
+
+        path = path.Replace('/', Path.DirectorySeparatorChar);
+
+        return currentDirectory is null || skipCombiningCurrentDirectory
+            ? path
+            : Path.Combine(currentDirectory, path);
+    }
+
+    [DiagnosticHelper("special-path-resolver")]
+    public static void SpecialPathResolverDiag(ILogger logger)
+    {
+        logger.LogInformation($"There are {_specialPathResolvers.Count} special path resolvers:");
+        foreach (var specialPathResolver in _specialPathResolvers)
+        {
+            logger.LogInformation($"{specialPathResolver.PathName} => {specialPathResolver.Resolver()}");
+        }
+    }
+}

src/Alma.Logging/Alma.Logging.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net7.0</TargetFramework>
+    <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
   </PropertyGroup>

src/Alma.Logging/ILogger.cs

@@ -1,6 +1,6 @@
 namespace Alma.Logging;
 
-public interface ILogger<T>
+public interface ILogger
 {
     LogLevel DefaultLogLevel { get; }
     void LogInformation(string logMessage);
@@ -9,4 +9,9 @@ public interface ILogger<T>
     void Log(string logMessage, LogLevel logLevel);
     void LogError(string logMessage);
     void LogCritical(string logMessage);
+}
+
+public interface ILogger<T> : ILogger
+{
+    
 }

src/Alma.Logging/ILoggerFactory.cs

@@ -3,5 +3,6 @@
 public interface ILoggerFactory
 {
     ILogger<T> CreateLogger<T>();
+    ILogger CreateLogger(Type t);
     LogLevel DefaultLogLevel { get; }
 }

src/Alma.Logging/Logger.cs

@@ -1,10 +1,11 @@
 namespace Alma.Logging;
 
-public class Logger<T> : ILogger<T>
+
+public class Logger : ILogger
 {
     public LogLevel DefaultLogLevel { get; }
 
-    public Logger(LogLevel defaultLogLevel)
+    public Logger(LogLevel defaultLogLevel, string topicName)
     {
         DefaultLogLevel = defaultLogLevel;
     }
@@ -32,4 +33,12 @@ public class Logger<T> : ILogger<T>
     {
         Log(logMessage, LogLevel.Critical);
     }
+}
+
+public class Logger<T> : Logger, ILogger<T>
+{
+    public Logger(LogLevel defaultLogLevel) : base(defaultLogLevel, typeof(T).Name)
+    {
+        
+    }
 }

src/Alma.Logging/LoggerFactory.cs

@@ -13,4 +13,9 @@ public class LoggerFactory : ILoggerFactory
     {
         return new Logger<T>(DefaultLogLevel);
     }
+
+    public ILogger CreateLogger(Type t)
+    {
+        return new Logger(DefaultLogLevel, t.Name);
+    }
 }

src/Alma/Alma.csproj

@@ -6,15 +6,15 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Jab" Version="0.8.4" />
+    <PackageReference Include="Jab" Version="0.10.2" />
   </ItemGroup>
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>net7.0</TargetFramework>
+    <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
-    <VersionPrefix>0.0.0</VersionPrefix>
+    <VersionPrefix>0.0.5</VersionPrefix>
     <VersionSuffix>development</VersionSuffix>
   </PropertyGroup>
 

src/Alma/Program.cs

@@ -1,4 +1,6 @@
 using Alma.Command;
+using Alma.Command.Configure;
+using Alma.Command.Diag;
 using Alma.Command.Help;
 using Alma.Command.Info;
 using Alma.Command.Install;
@@ -18,6 +20,14 @@ public static class Program
     {
         InitLogging();
 
+        var logger = AlmaLoggerFactory.CreateLogger(typeof(Program));
+
+        var workdir = GetWorkdir(logger);
+        if (workdir != null)
+        {
+            Environment.CurrentDirectory = workdir;
+        }
+
         var services = new AlmaServiceProvider();
 
         var repositoryConfiguration = services.GetService<IRepositoryConfiguration>();
@@ -27,6 +37,33 @@ public static class Program
         await application.Run(args);
     }
 
+    private static string? GetWorkdir(ILogger logger)
+    {
+        var workdirProviders = new Dictionary<string, Func<string?>>
+        {
+            {"ALMA_WORKDIR", () => Environment.GetEnvironmentVariable("ALMA_WORKDIR")},
+            {"WORKDIR", () => Environment.GetEnvironmentVariable("WORKDIR")},
+        };
+
+        foreach (var workdirProvider in workdirProviders)
+        {
+            var workdir = workdirProvider.Value();
+            if (workdir != null)
+            {
+                if (Directory.Exists(workdir))
+                {
+                    return workdir;
+                }
+                else
+                {
+                    logger.LogInformation($"{workdirProvider.Key} is set to {workdir} but this directory does not exist.");
+                }
+            }
+        }
+
+        return null;
+    }
+
     private static void InitLogging()
     {
         AlmaLoggerFactory = new LoggerFactory();
@@ -47,10 +84,14 @@ public static class Program
 [Singleton(typeof(ICommand), typeof(ListCommand))]
 [Singleton(typeof(ICommand), typeof(InstallCommand))]
 [Singleton(typeof(ICommand), typeof(HelpCommand))]
+[Singleton(typeof(ICommand), typeof(ConfigureCommand))]
+[Singleton(typeof(ICommand), typeof(DiagCommand))]
+[Singleton(typeof(ICommand), typeof(ReadMeCommand))]
 [Singleton(typeof(IModuleConfigurationResolver), typeof(ModuleConfigurationResolver))]
 [Singleton(typeof(IMetadataHandler), typeof(MetadataHandler))]
 [Singleton(typeof(IShellService), typeof(ShellService))]
 [Singleton(typeof(IVersionService), typeof(VersionService))]
+[Singleton(typeof(IPathHelperService), typeof(PathHelperService))]
 [Singleton(typeof(Application))]
 [Transient(typeof(ILogger<>), Factory = nameof(CustomLoggerFactory))]
 internal partial class AlmaServiceProvider