@alexgorbatchev/dotfiles 0.0.5 → 0.0.10

package/skill/references/installation-methods/brew.md

@@ -7,29 +7,29 @@ Shims are not supported for Homebrew-installed tools. The `.bin()` method should
 ## Basic Usage
 
 ```typescript
-import { defineTool } from '@alexgorbatchev/dotfiles';
+import { defineTool } from "@alexgorbatchev/dotfiles";
 
-export default defineTool((install) => install('brew', { formula: 'ripgrep' }));
+export default defineTool((install) => install("brew", { formula: "ripgrep" }));
 ```
 
 ## Parameters
 
-| Parameter      | Description                                         |
-| -------------- | --------------------------------------------------- |
-| `formula`      | Formula or cask name (defaults to tool name)        |
-| `cask`         | Set `true` for cask installation                    |
-| `tap`          | Tap(s) to add before installing                     |
-| `versionArgs`  | Arguments for version check (e.g., `['--version']`) |
-| `versionRegex` | Regex to extract version from output                |
-| `env`          | Environment variables (static or dynamic function)  |
+| Parameter      | Description                                                 |
+| -------------- | ----------------------------------------------------------- |
+| `formula`      | Formula or cask name (defaults to tool name)                |
+| `cask`         | Set `true` for cask installation                            |
+| `tap`          | Tap(s) to add before installing                             |
+| `versionArgs`  | Arguments for version check (e.g., `['--version']`)         |
+| `versionRegex` | Regex to extract version from output (`string` or `RegExp`) |
+| `env`          | Environment variables (static or dynamic function)          |
 
 ## Examples
 
 ### Homebrew Cask
 
 ```typescript
-install('brew', {
-  formula: 'visual-studio-code',
+install("brew", {
+  formula: "visual-studio-code",
   cask: true,
 });
 ```
@@ -37,19 +37,19 @@ install('brew', {
 ### With Custom Tap
 
 ```typescript
-install('brew', {
-  formula: 'aerospace',
+install("brew", {
+  formula: "aerospace",
   cask: true,
-  tap: 'nikitabobko/tap',
+  tap: "nikitabobko/tap",
 });
 ```
 
 ### Multiple Taps
 
 ```typescript
-install('brew', {
-  formula: 'custom-tool',
-  tap: ['custom/tap', 'another/tap'],
+install("brew", {
+  formula: "custom-tool",
+  tap: ["custom/tap", "another/tap"],
 });
 ```
 

package/skill/references/installation-methods/cargo.md

@@ -5,12 +5,12 @@ Installs Rust tools from crates.io using pre-compiled binaries via cargo-quickin
 ## Basic Usage
 
 ```typescript
-import { defineTool } from '@alexgorbatchev/dotfiles';
+import { defineTool } from "@alexgorbatchev/dotfiles";
 
 export default defineTool((install, ctx) =>
-  install('cargo', {
-    crateName: 'ripgrep',
-  }).bin('rg')
+  install("cargo", {
+    crateName: "ripgrep",
+  }).bin("rg"),
 );
 ```
 
@@ -42,12 +42,12 @@ export default defineTool((install, ctx) =>
 
 ```typescript
 export default defineTool((install, ctx) =>
-  install('cargo', {
-    crateName: 'bat',
-    binarySource: 'github-releases',
-    githubRepo: 'sharkdp/bat',
-    assetPattern: 'bat-v{version}-{arch}-{platform}.tar.gz',
-  }).bin('bat')
+  install("cargo", {
+    crateName: "bat",
+    binarySource: "github-releases",
+    githubRepo: "sharkdp/bat",
+    assetPattern: "bat-v{version}-{arch}-{platform}.tar.gz",
+  }).bin("bat"),
 );
 ```
 
@@ -55,10 +55,10 @@ export default defineTool((install, ctx) =>
 
 ```typescript
 export default defineTool((install, ctx) =>
-  install('cargo', {
-    crateName: 'fd-find',
-    customBinaries: ['fd'],
-  }).bin('fd')
+  install("cargo", {
+    crateName: "fd-find",
+    customBinaries: ["fd"],
+  }).bin("fd"),
 );
 ```
 
@@ -66,13 +66,13 @@ export default defineTool((install, ctx) =>
 
 ```typescript
 export default defineTool((install, ctx) =>
-  install('cargo', {
-    crateName: 'tool',
+  install("cargo", {
+    crateName: "tool",
   })
-    .bin('tool')
-    .hook('after-install', async (ctx) => {
+    .bin("tool")
+    .hook("after-install", async (ctx) => {
       // Post-installation setup
-    })
+    }),
 );
 ```
 

package/skill/references/installation-methods/curl-binary.md

@@ -5,62 +5,64 @@ Download standalone binary files directly from URLs. Unlike `curl-tar`, this met
 ## Basic Usage
 
 ```typescript
-import { defineTool } from '@alexgorbatchev/dotfiles';
+import { defineTool } from "@alexgorbatchev/dotfiles";
 
 export default defineTool((install) =>
-  install('curl-binary', {
-    url: 'https://example.com/tool-v1.0.0-linux-amd64',
-  }).bin('tool')
+  install("curl-binary", {
+    url: "https://example.com/tool-v1.0.0-linux-amd64",
+  }).bin("tool"),
 );
 ```
 
 ## Parameters
 
-| Parameter      | Description                                         |
-| -------------- | --------------------------------------------------- |
-| `url`          | **Required**. Direct URL to the binary file         |
-| `versionArgs`  | Arguments for version check (e.g., `['--version']`) |
-| `versionRegex` | Regex to extract version from output                |
-| `env`          | Environment variables (static or dynamic function)  |
+| Parameter      | Description                                                 |
+| -------------- | ----------------------------------------------------------- |
+| `url`          | **Required**. Direct URL to the binary file                 |
+| `versionArgs`  | Arguments for version check (e.g., `['--version']`)         |
+| `versionRegex` | Regex to extract version from output (`string` or `RegExp`) |
+| `env`          | Environment variables (static or dynamic function)          |
 
 ## Examples
 
 ### With Version Detection
 
 ```typescript
-install('curl-binary', {
-  url: 'https://example.com/tool-v1.0.0-linux-amd64',
-  versionArgs: ['--version'],
-  versionRegex: 'v(\\d+\\.\\d+\\.\\d+)',
-}).bin('tool');
+install("curl-binary", {
+  url: "https://example.com/tool-v1.0.0-linux-amd64",
+  versionArgs: ["--version"],
+  versionRegex: /v(\d+\.\d+\.\d+)/,
+}).bin("tool");
 ```
 
 ### With Shell Configuration
 
 ```typescript
-install('curl-binary', {
-  url: 'https://example.com/tool-v1.0.0-linux-amd64',
+install("curl-binary", {
+  url: "https://example.com/tool-v1.0.0-linux-amd64",
 })
-  .bin('tool')
-  .zsh((shell) => shell.aliases({ t: 'tool' }));
+  .bin("tool")
+  .zsh((shell) => shell.aliases({ t: "tool" }));
 ```
 
 ### Platform-Specific URLs
 
 ```typescript
-import { Architecture, defineTool, Platform } from '@alexgorbatchev/dotfiles';
+import { Architecture, defineTool, Platform } from "@alexgorbatchev/dotfiles";
 
 export default defineTool((install) =>
   install()
-    .bin('tool')
+    .bin("tool")
     .platform(Platform.MacOS, Architecture.Arm64, (install) =>
-      install('curl-binary', {
-        url: 'https://example.com/tool-darwin-arm64',
-      }))
+      install("curl-binary", {
+        url: "https://example.com/tool-darwin-arm64",
+      }),
+    )
     .platform(Platform.Linux, Architecture.X86_64, (install) =>
-      install('curl-binary', {
-        url: 'https://example.com/tool-linux-amd64',
-      }))
+      install("curl-binary", {
+        url: "https://example.com/tool-linux-amd64",
+      }),
+    ),
 );
 ```
 

package/skill/references/installation-methods/curl-script.md

@@ -5,13 +5,13 @@ Downloads and executes shell installation scripts.
 ## Basic Usage
 
 ```typescript
-import { defineTool } from '@alexgorbatchev/dotfiles';
+import { defineTool } from "@alexgorbatchev/dotfiles";
 
 export default defineTool((install, ctx) =>
-  install('curl-script', {
-    url: 'https://bun.sh/install',
-    shell: 'bash',
-  }).bin('bun')
+  install("curl-script", {
+    url: "https://bun.sh/install",
+    shell: "bash",
+  }).bin("bun"),
 );
 ```
 
@@ -24,7 +24,7 @@ export default defineTool((install, ctx) =>
 | `args`         | `string[] \| (ctx) => string[]`                  | No       | Arguments to pass to the script           |
 | `env`          | `Record<string, string> \| (ctx) => Record<...>` | No       | Environment variables (static or dynamic) |
 | `versionArgs`  | `string[]`                                       | No       | Args to pass to binary for version check  |
-| `versionRegex` | `string`                                         | No       | Regex to extract version from output      |
+| `versionRegex` | `string \| RegExp`                               | No       | Regex to extract version from output      |
 
 > **Note:** The `env` and `args` parameters support both static values and dynamic functions. Dynamic functions receive a context with `projectConfig`, `scriptPath`, and `stagingDir`.
 
@@ -54,10 +54,10 @@ Then use `args` or `env` with the dynamic context to redirect:
 
 ```typescript
 // Using args (if script accepts command-line arguments)
-args: ((ctx) => ['--install-dir', ctx.stagingDir]);
+args: (ctx) => ["--install-dir", ctx.stagingDir];
 
 // Using env (if script reads environment variables)
-env: ((ctx) => ({ FLYCTL_INSTALL: ctx.stagingDir }));
+env: (ctx) => ({ FLYCTL_INSTALL: ctx.stagingDir });
 ```
 
 ## Examples
@@ -66,11 +66,11 @@ env: ((ctx) => ({ FLYCTL_INSTALL: ctx.stagingDir }));
 
 ```typescript
 export default defineTool((install, ctx) =>
-  install('curl-script', {
-    url: 'https://fnm.vercel.app/install',
-    shell: 'bash',
-    args: ['--skip-shell', '--install-dir', '$LOCAL_BIN'],
-  }).bin('fnm')
+  install("curl-script", {
+    url: "https://fnm.vercel.app/install",
+    shell: "bash",
+    args: ["--skip-shell", "--install-dir", "$LOCAL_BIN"],
+  }).bin("fnm"),
 );
 ```
 
@@ -78,11 +78,11 @@ export default defineTool((install, ctx) =>
 
 ```typescript
 export default defineTool((install, ctx) =>
-  install('curl-script', {
-    url: 'https://fnm.vercel.app/install',
-    shell: 'bash',
-    args: (argsCtx) => ['--install-dir', argsCtx.stagingDir],
-  }).bin('fnm')
+  install("curl-script", {
+    url: "https://fnm.vercel.app/install",
+    shell: "bash",
+    args: (argsCtx) => ["--install-dir", argsCtx.stagingDir],
+  }).bin("fnm"),
 );
 ```
 
@@ -98,11 +98,11 @@ Use dynamic `env` to redirect installation to `stagingDir`:
 
 ```typescript
 export default defineTool((install, ctx) =>
-  install('curl-script', {
-    url: 'https://fly.io/install.sh',
-    shell: 'sh',
+  install("curl-script", {
+    url: "https://fly.io/install.sh",
+    shell: "sh",
     env: (ctx) => ({ FLYCTL_INSTALL: ctx.stagingDir }),
-  }).bin('flyctl', 'fly')
+  }).bin("flyctl", "fly"),
 );
 ```
 
@@ -118,14 +118,14 @@ The `env` context provides:
 
 ```typescript
 export default defineTool((install, ctx) =>
-  install('curl-script', {
-    url: 'https://example.com/install.sh',
-    shell: 'bash',
+  install("curl-script", {
+    url: "https://example.com/install.sh",
+    shell: "bash",
   })
-    .bin('tool')
-    .hook('after-download', async (ctx) => {
+    .bin("tool")
+    .hook("after-download", async (ctx) => {
       // Verify script before execution
-    })
+    }),
 );
 ```
 

package/skill/references/installation-methods/curl-tar.md

@@ -5,44 +5,52 @@ Download and extract tarballs directly from URLs.
 ## Basic Usage
 
 ```typescript
-import { defineTool } from '@alexgorbatchev/dotfiles';
+import { defineTool } from "@alexgorbatchev/dotfiles";
 
 export default defineTool((install) =>
-  install('curl-tar', {
-    url: 'https://example.com/tool.tar.gz',
-  }).bin('tool')
+  install("curl-tar", {
+    url: "https://example.com/tool.tar.gz",
+  }).bin("tool"),
 );
 ```
 
 ## Parameters
 
-| Parameter         | Description                                         |
-| ----------------- | --------------------------------------------------- |
-| `url`             | **Required**. Direct URL to the tarball             |
-| `extractPath`     | Path to binary within extracted archive             |
-| `stripComponents` | Directory levels to strip during extraction         |
-| `versionArgs`     | Arguments for version check (e.g., `['--version']`) |
-| `versionRegex`    | Regex to extract version from output                |
-| `env`             | Environment variables (static or dynamic function)  |
+| Parameter      | Description                                                 |
+| -------------- | ----------------------------------------------------------- |
+| `url`          | **Required**. Direct URL to the tarball                     |
+| `versionArgs`  | Arguments for version check (e.g., `['--version']`)         |
+| `versionRegex` | Regex to extract version from output (`string` or `RegExp`) |
+| `env`          | Environment variables (static or dynamic function)          |
 
 ## Examples
 
 ### Binary in Subdirectory
 
 ```typescript
-install('curl-tar', {
-  url: 'https://releases.example.com/tool-v1.0.0.tar.gz',
-}).bin('tool', 'bin/tool'); // Binary at bin/tool in archive
+install("curl-tar", {
+  url: "https://releases.example.com/tool-v1.0.0.tar.gz",
+}).bin("tool", "bin/tool"); // Binary at bin/tool in archive
+```
+
+### With Version Detection
+
+```typescript
+install("curl-tar", {
+  url: "https://releases.example.com/tool-v1.0.0.tar.gz",
+  versionArgs: ["--version"],
+  versionRegex: /tool (\d+\.\d+\.\d+)/,
+}).bin("tool");
 ```
 
 ### With Shell Configuration
 
 ```typescript
-install('curl-tar', {
-  url: 'https://releases.example.com/tool-v1.0.0.tar.gz',
+install("curl-tar", {
+  url: "https://releases.example.com/tool-v1.0.0.tar.gz",
 })
-  .bin('tool')
-  .zsh((shell) => shell.aliases({ t: 'tool' }));
+  .bin("tool")
+  .zsh((shell) => shell.aliases({ t: "tool" }));
 ```
 
 ## Supported Formats

package/skill/references/installation-methods/dmg.md

@@ -13,15 +13,15 @@ Shims are not supported for DMG-installed applications. The `.bin()` method shou
 ## Basic Usage
 
 ```typescript
-import { defineTool } from '@alexgorbatchev/dotfiles';
+import { defineTool } from "@alexgorbatchev/dotfiles";
 
 export default defineTool((install) =>
-  install('dmg', {
+  install("dmg", {
     source: {
-      type: 'url',
-      url: 'https://example.com/MyApp-1.0.0.dmg',
+      type: "url",
+      url: "https://example.com/MyApp-1.0.0.dmg",
     },
-  })
+  }),
 );
 ```
 
@@ -33,7 +33,7 @@ export default defineTool((install) =>
 | `appName`      | Name of the `.app` bundle (e.g., `'MyApp.app'`). Auto-detected if omitted      |
 | `binaryPath`   | Relative path to binary inside `.app`. Defaults to `Contents/MacOS/{bin name}` |
 | `versionArgs`  | Arguments for version check (e.g., `['--version']`)                            |
-| `versionRegex` | Regex to extract version from output                                           |
+| `versionRegex` | Regex to extract version from output (`string` or `RegExp`)                    |
 | `env`          | Environment variables (static or dynamic function)                             |
 
 ### Source Variants
@@ -48,22 +48,22 @@ export default defineTool((install) =>
 ### Explicit App Name
 
 ```typescript
-install('dmg', {
+install("dmg", {
   source: {
-    type: 'url',
-    url: 'https://example.com/MyApp-1.0.0.dmg',
+    type: "url",
+    url: "https://example.com/MyApp-1.0.0.dmg",
   },
-  appName: 'MyApp.app',
-}).version('1.0.0');
+  appName: "MyApp.app",
+}).version("1.0.0");
 ```
 
 ### From Archive Containing DMG
 
 ```typescript
-install('dmg', {
+install("dmg", {
   source: {
-    type: 'url',
-    url: 'https://github.com/example/app/releases/download/v1.0.0/MyApp.dmg.zip',
+    type: "url",
+    url: "https://github.com/example/app/releases/download/v1.0.0/MyApp.dmg.zip",
   },
 });
 ```
@@ -71,26 +71,26 @@ install('dmg', {
 ### GitHub Release Source
 
 ```typescript
-install('dmg', {
+install("dmg", {
   source: {
-    type: 'github-release',
-    repo: 'manaflow-ai/cmux',
-    assetPattern: '*macos*.dmg',
+    type: "github-release",
+    repo: "manaflow-ai/cmux",
+    assetPattern: "*macos*.dmg",
   },
-  appName: 'cmux.app',
+  appName: "cmux.app",
 });
 ```
 
 ### With Version Detection
 
 ```typescript
-install('dmg', {
+install("dmg", {
   source: {
-    type: 'url',
-    url: 'https://example.com/MyApp-1.0.0.dmg',
+    type: "url",
+    url: "https://example.com/MyApp-1.0.0.dmg",
   },
-  versionArgs: ['--version'],
-  versionRegex: 'v(\\d+\\.\\d+\\.\\d+)',
+  versionArgs: ["--version"],
+  versionRegex: /v(\d+\.\d+\.\d+)/,
 });
 ```
 

package/skill/references/installation-methods/gitea-release.md

@@ -5,13 +5,13 @@ Download and install tools from Gitea or Forgejo instance releases with automati
 ## Basic Usage
 
 ```typescript
-import { defineTool } from '@alexgorbatchev/dotfiles';
+import { defineTool } from "@alexgorbatchev/dotfiles";
 
 export default defineTool((install) =>
-  install('gitea-release', {
-    instanceUrl: 'https://codeberg.org',
-    repo: 'Codeberg/pages-server',
-  }).bin('pages-server')
+  install("gitea-release", {
+    instanceUrl: "https://codeberg.org",
+    repo: "Codeberg/pages-server",
+  }).bin("pages-server"),
 );
 ```
 
@@ -33,34 +33,34 @@ export default defineTool((install) =>
 ### With Asset Pattern
 
 ```typescript
-install('gitea-release', {
-  instanceUrl: 'https://codeberg.org',
-  repo: 'owner/tool',
-  assetPattern: '*linux_amd64.tar.gz',
-}).bin('tool');
+install("gitea-release", {
+  instanceUrl: "https://codeberg.org",
+  repo: "owner/tool",
+  assetPattern: "*linux_amd64.tar.gz",
+}).bin("tool");
 ```
 
 ### Custom Asset Selector
 
 ```typescript
-install('gitea-release', {
-  instanceUrl: 'https://codeberg.org',
-  repo: 'owner/tool',
+install("gitea-release", {
+  instanceUrl: "https://codeberg.org",
+  repo: "owner/tool",
   assetSelector: ({ assets, systemInfo }) => {
-    const platform = systemInfo.platform === 'darwin' ? 'macos' : systemInfo.platform;
+    const platform = systemInfo.platform === "darwin" ? "macos" : systemInfo.platform;
     return assets.find((a) => a.name.includes(platform));
   },
-}).bin('tool');
+}).bin("tool");
 ```
 
 ### Specific Version
 
 ```typescript
-install('gitea-release', {
-  instanceUrl: 'https://codeberg.org',
-  repo: 'owner/tool',
-  version: 'v2.1.0',
-}).bin('tool');
+install("gitea-release", {
+  instanceUrl: "https://codeberg.org",
+  repo: "owner/tool",
+  version: "v2.1.0",
+}).bin("tool");
 ```
 
 ### With Authentication Token
@@ -68,11 +68,11 @@ install('gitea-release', {
 For private repositories or to avoid rate limits:
 
 ```typescript
-install('gitea-release', {
-  instanceUrl: 'https://gitea.example.com',
-  repo: 'org/private-tool',
+install("gitea-release", {
+  instanceUrl: "https://gitea.example.com",
+  repo: "org/private-tool",
   token: process.env.GITEA_TOKEN,
-}).bin('tool');
+}).bin("tool");
 ```
 
 ## Asset Pattern Matching