🛟 Updated.
48d4273 parent: c2ad262 added
.tickets/issues/0121-mm-init-add-the-urls-in-the-agent-yaml-file.yaml +14 -0 | new file mode 100644 | ||
| @@ -0,0 +1,14 @@ | ||
| 1 | +# Managed by IssueSpec. Hand edits are welcome; keep the schema valid. | |
| 2 | +id: 121 | |
| 3 | +title: mm init, add the urls in the agent.yaml file | |
| 4 | +state: open | |
| 5 | +author: | |
| 6 | + name: k33g | |
| 7 | + email: ph.charriere@gmail.com | |
| 8 | +createdAt: 2026-10-22T03:55:46.925Z | |
| 9 | +updatedAt: 2026-10-22T03:55:46.925Z | |
| 10 | +labels: [] | |
| 11 | +milestone: v1.0.0 | |
| 12 | +body: "" | |
| 13 | +tasks: [] | |
| 14 | +comments: [] | |
| new file mode 100644 | |||
| @@ -0,0 +1,14 @@ | |||
| 1 | +# Managed by IssueSpec. Hand edits are welcome; keep the schema valid. | ||
| 2 | +id: 121 | ||
| 3 | +title: mm init, add the urls in the agent.yaml file | ||
| 4 | +state: open | ||
| 5 | +author: | ||
| 6 | + name: k33g | ||
| 7 | + email: ph.charriere@gmail.com | ||
| 8 | +createdAt: 2026-10-22T03:55:46.925Z | ||
| 9 | +updatedAt: 2026-10-22T03:55:46.925Z | ||
| 10 | +labels: [] | ||
| 11 | +milestone: v1.0.0 | ||
| 12 | +body: "" | ||
| 13 | +tasks: [] | ||
| 14 | +comments: [] | ||
added
.tickets/issues/0122-open-a-shell-window.yaml +14 -0 | new file mode 100644 | ||
| @@ -0,0 +1,14 @@ | ||
| 1 | +# Managed by IssueSpec. Hand edits are welcome; keep the schema valid. | |
| 2 | +id: 122 | |
| 3 | +title: Open a shell window | |
| 4 | +state: open | |
| 5 | +author: | |
| 6 | + name: k33g | |
| 7 | + email: ph.charriere@gmail.com | |
| 8 | +createdAt: 2026-10-22T03:58:02.231Z | |
| 9 | +updatedAt: 2026-10-22T03:58:02.231Z | |
| 10 | +labels: [] | |
| 11 | +milestone: v1.0.0 | |
| 12 | +body: "" | |
| 13 | +tasks: [] | |
| 14 | +comments: [] | |
| new file mode 100644 | |||
| @@ -0,0 +1,14 @@ | |||
| 1 | +# Managed by IssueSpec. Hand edits are welcome; keep the schema valid. | ||
| 2 | +id: 122 | ||
| 3 | +title: Open a shell window | ||
| 4 | +state: open | ||
| 5 | +author: | ||
| 6 | + name: k33g | ||
| 7 | + email: ph.charriere@gmail.com | ||
| 8 | +createdAt: 2026-10-22T03:58:02.231Z | ||
| 9 | +updatedAt: 2026-10-22T03:58:02.231Z | ||
| 10 | +labels: [] | ||
| 11 | +milestone: v1.0.0 | ||
| 12 | +body: "" | ||
| 13 | +tasks: [] | ||
| 14 | +comments: [] | ||
added
INSTALL.LINUX.md +28 -0 | new file mode 100644 | ||
| @@ -0,0 +1,28 @@ | ||
| 1 | +# Install `mm` on Linux | |
| 2 | + | |
| 3 | +```bash | |
| 4 | +# download the binary release in https://rickub.com/bots-garden/mini-me/releases | |
| 5 | +VERSION=0.9.0 | |
| 6 | +case "$(uname -m)" in | |
| 7 | + x86_64) ARCH=amd64 ;; | |
| 8 | + aarch64|arm64) ARCH=arm64 ;; | |
| 9 | + *) echo "no mm release for $(uname -m)"; exit 1 ;; | |
| 10 | +esac | |
| 11 | +curl -fsSLO "https://rickub.com/bots-garden/mini-me/releases/download/v${VERSION}/mm-${VERSION}-linux-${ARCH}" | |
| 12 | + | |
| 13 | +# optional: check the download against the release's checksums | |
| 14 | +curl -fsSLO "https://rickub.com/bots-garden/mini-me/releases/download/v${VERSION}/SHA256SUMS" | |
| 15 | +sha256sum -c --ignore-missing SHA256SUMS | |
| 16 | + | |
| 17 | +chmod +x ./mm-${VERSION}-linux-${ARCH} | |
| 18 | +sudo rm -f /usr/local/bin/mm | |
| 19 | +sudo cp ./mm-${VERSION}-linux-${ARCH} /usr/local/bin/mm | |
| 20 | +mm --version | |
| 21 | +``` | |
| 22 | + | |
| 23 | +Without `sudo`, install it in your own `~/.local/bin` (on the `PATH` of most distributions): | |
| 24 | + | |
| 25 | +```bash | |
| 26 | +mkdir -p ~/.local/bin | |
| 27 | +cp ./mm-${VERSION}-linux-${ARCH} ~/.local/bin/mm | |
| 28 | +``` | |
| new file mode 100644 | |||
| @@ -0,0 +1,28 @@ | |||
| 1 | +# Install `mm` on Linux | ||
| 2 | + | ||
| 3 | +```bash | ||
| 4 | +# download the binary release in https://rickub.com/bots-garden/mini-me/releases | ||
| 5 | +VERSION=0.9.0 | ||
| 6 | +case "$(uname -m)" in | ||
| 7 | + x86_64) ARCH=amd64 ;; | ||
| 8 | + aarch64|arm64) ARCH=arm64 ;; | ||
| 9 | + *) echo "no mm release for $(uname -m)"; exit 1 ;; | ||
| 10 | +esac | ||
| 11 | +curl -fsSLO "https://rickub.com/bots-garden/mini-me/releases/download/v${VERSION}/mm-${VERSION}-linux-${ARCH}" | ||
| 12 | + | ||
| 13 | +# optional: check the download against the release's checksums | ||
| 14 | +curl -fsSLO "https://rickub.com/bots-garden/mini-me/releases/download/v${VERSION}/SHA256SUMS" | ||
| 15 | +sha256sum -c --ignore-missing SHA256SUMS | ||
| 16 | + | ||
| 17 | +chmod +x ./mm-${VERSION}-linux-${ARCH} | ||
| 18 | +sudo rm -f /usr/local/bin/mm | ||
| 19 | +sudo cp ./mm-${VERSION}-linux-${ARCH} /usr/local/bin/mm | ||
| 20 | +mm --version | ||
| 21 | +``` | ||
| 22 | + | ||
| 23 | +Without `sudo`, install it in your own `~/.local/bin` (on the `PATH` of most distributions): | ||
| 24 | + | ||
| 25 | +```bash | ||
| 26 | +mkdir -p ~/.local/bin | ||
| 27 | +cp ./mm-${VERSION}-linux-${ARCH} ~/.local/bin/mm | ||
| 28 | +``` | ||
added
INSTALL.WINDOWS.md +39 -0 | new file mode 100644 | ||
| @@ -0,0 +1,39 @@ | ||
| 1 | +# Install `mm` on Windows | |
| 2 | + | |
| 3 | +In PowerShell (no administrator rights needed): | |
| 4 | + | |
| 5 | +```powershell | |
| 6 | +# download the binary release in https://rickub.com/bots-garden/mini-me/releases | |
| 7 | +$Version = "0.9.0" | |
| 8 | +$Arch = if ($env:PROCESSOR_ARCHITECTURE -eq "ARM64") { "arm64" } else { "amd64" } | |
| 9 | +$Asset = "mm-$Version-windows-$Arch.exe" | |
| 10 | +$Base = "https://rickub.com/bots-garden/mini-me/releases/download/v$Version" | |
| 11 | +Invoke-WebRequest -Uri "$Base/$Asset" -OutFile $Asset | |
| 12 | + | |
| 13 | +# optional: check the download against the release's checksums (True = OK) | |
| 14 | +Invoke-WebRequest -Uri "$Base/SHA256SUMS" -OutFile SHA256SUMS | |
| 15 | +$Expected = ((Select-String -Path SHA256SUMS -Pattern $Asset -SimpleMatch).Line -split '\s+')[0] | |
| 16 | +(Get-FileHash $Asset -Algorithm SHA256).Hash.ToLower() -eq $Expected | |
| 17 | + | |
| 18 | +# install it in your own programs folder, and put that folder on your PATH once | |
| 19 | +$Dir = "$env:LOCALAPPDATA\Programs\mm" | |
| 20 | +New-Item -ItemType Directory -Force -Path $Dir | Out-Null | |
| 21 | +Copy-Item $Asset "$Dir\mm.exe" -Force | |
| 22 | +$UserPath = [Environment]::GetEnvironmentVariable("Path", "User") | |
| 23 | +if ($UserPath -notlike "*$Dir*") { | |
| 24 | + [Environment]::SetEnvironmentVariable("Path", "$UserPath;$Dir", "User") | |
| 25 | +} | |
| 26 | +``` | |
| 27 | + | |
| 28 | +Open a new terminal (the `PATH` change applies to new ones only), then: | |
| 29 | + | |
| 30 | +```powershell | |
| 31 | +mm --version | |
| 32 | +``` | |
| 33 | + | |
| 34 | +## Before the first run | |
| 35 | + | |
| 36 | +- **`bash` and `sh`.** mm's `bash` tool runs `bash -c <command>`, and a hook written as a `command:` runs `sh -c <command>`. Install [Git for Windows](https://git-scm.com/download/win) and put its `bin` folder (`C:\Program Files\Git\bin`, which holds `bash.exe` and `sh.exe`) on your `PATH`, or turn the tool off with `bashTool: false`. WebAssembly tools and hooks need neither. | |
| 37 | +- **A file downloaded with a browser** may be blocked by SmartScreen: `Unblock-File .\mm-$Version-windows-$Arch.exe` before copying it. | |
| 38 | + | |
| 39 | +These steps have not been tried on a Windows machine yet: the commands are checked against the release's file names and URLs only. | |
| new file mode 100644 | |||
| @@ -0,0 +1,39 @@ | |||
| 1 | +# Install `mm` on Windows | ||
| 2 | + | ||
| 3 | +In PowerShell (no administrator rights needed): | ||
| 4 | + | ||
| 5 | +```powershell | ||
| 6 | +# download the binary release in https://rickub.com/bots-garden/mini-me/releases | ||
| 7 | +$Version = "0.9.0" | ||
| 8 | +$Arch = if ($env:PROCESSOR_ARCHITECTURE -eq "ARM64") { "arm64" } else { "amd64" } | ||
| 9 | +$Asset = "mm-$Version-windows-$Arch.exe" | ||
| 10 | +$Base = "https://rickub.com/bots-garden/mini-me/releases/download/v$Version" | ||
| 11 | +Invoke-WebRequest -Uri "$Base/$Asset" -OutFile $Asset | ||
| 12 | + | ||
| 13 | +# optional: check the download against the release's checksums (True = OK) | ||
| 14 | +Invoke-WebRequest -Uri "$Base/SHA256SUMS" -OutFile SHA256SUMS | ||
| 15 | +$Expected = ((Select-String -Path SHA256SUMS -Pattern $Asset -SimpleMatch).Line -split '\s+')[0] | ||
| 16 | +(Get-FileHash $Asset -Algorithm SHA256).Hash.ToLower() -eq $Expected | ||
| 17 | + | ||
| 18 | +# install it in your own programs folder, and put that folder on your PATH once | ||
| 19 | +$Dir = "$env:LOCALAPPDATA\Programs\mm" | ||
| 20 | +New-Item -ItemType Directory -Force -Path $Dir | Out-Null | ||
| 21 | +Copy-Item $Asset "$Dir\mm.exe" -Force | ||
| 22 | +$UserPath = [Environment]::GetEnvironmentVariable("Path", "User") | ||
| 23 | +if ($UserPath -notlike "*$Dir*") { | ||
| 24 | + [Environment]::SetEnvironmentVariable("Path", "$UserPath;$Dir", "User") | ||
| 25 | +} | ||
| 26 | +``` | ||
| 27 | + | ||
| 28 | +Open a new terminal (the `PATH` change applies to new ones only), then: | ||
| 29 | + | ||
| 30 | +```powershell | ||
| 31 | +mm --version | ||
| 32 | +``` | ||
| 33 | + | ||
| 34 | +## Before the first run | ||
| 35 | + | ||
| 36 | +- **`bash` and `sh`.** mm's `bash` tool runs `bash -c <command>`, and a hook written as a `command:` runs `sh -c <command>`. Install [Git for Windows](https://git-scm.com/download/win) and put its `bin` folder (`C:\Program Files\Git\bin`, which holds `bash.exe` and `sh.exe`) on your `PATH`, or turn the tool off with `bashTool: false`. WebAssembly tools and hooks need neither. | ||
| 37 | +- **A file downloaded with a browser** may be blocked by SmartScreen: `Unblock-File .\mm-$Version-windows-$Arch.exe` before copying it. | ||
| 38 | + | ||
| 39 | +These steps have not been tried on a Windows machine yet: the commands are checked against the release's file names and URLs only. | ||