@@ -0,0 +1,28 @@
+name: build-appimage
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 9 * * 1"   # weekly: catch new Muse Code releases
+permissions:
+  contents: read
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install deps
+        run: sudo apt-get update && sudo apt-get install -y --no-install-recommends file desktop-file-utils
+      - name: Validate desktop file
+        run: desktop-file-validate packaging/muse-code.desktop
+      - name: Build AppImage (fetches + sha256-verifies Meta's binary)
+        run: ./build-appimage.sh
+      - name: Check --version
+        run: |
+          out="$(./Muse-Code-x86_64.AppImage --version)"
+          echo "$out"
+          echo "$out" | grep -E '^Muse Code [0-9]+\.[0-9]+\.[0-9]+'
+      # The AppImage is intentionally NOT uploaded as an artifact or release:
+      # Muse Code is Meta's proprietary binary and is not redistributed here.
@@ -0,0 +1,7 @@
+*.AppImage
+build/
+muse
+muse-x86-linux
+muse-*-linux
+*.part
+AppDir/
@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 Neal Frazier
+
+This license covers ONLY the build scripts, packaging files and artwork in
+this repository. It does not cover Muse Code itself, which is proprietary
+software by Meta Platforms, Inc., is not included here, and is downloaded
+from Meta at build time under Meta's own terms.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
@@ -0,0 +1,55 @@
+<p align="center"><img src="assets/hero.png" alt="Muse Code on Linux — AppImage" width="100%"></p>
+
+# Muse Code on Linux (AppImage)
+
+Build a single-file **AppImage** of Meta's official **Muse Code** CLI for x86_64 Linux.
+Run it from a terminal, or double-click it and it opens in Konsole (or your system terminal).
+Tested on **ZOTHOS** (KDE Plasma).
+
+> **Unofficial community packaging. Not affiliated with, endorsed by, or supported by Meta.**
+> This repo contains **no Meta binaries**. `build-appimage.sh` downloads `muse-x86-linux`
+> from Meta's own release channel at build time and verifies its sha256 against Meta's
+> manifest before packaging it. Don't redistribute the resulting AppImage.
+
+## Quickstart
+
+```bash
+git clone https://github.com/<you>/muse-code-linux.git
+cd muse-code-linux
+./build-appimage.sh                      # needs curl, python3, sha256sum
+./Muse-Code-x86_64.AppImage --version    # -> Muse Code 1.4.6 (1.4.6-R6000.1)
+./Muse-Code-x86_64.AppImage login        # first run: sign in
+```
+
+Optional: put it on your PATH as `muse`:
+
+```bash
+mkdir -p ~/Applications ~/.local/bin
+mv Muse-Code-x86_64.AppImage ~/Applications/
+ln -sf ~/Applications/Muse-Code-x86_64.AppImage ~/.local/bin/muse
+```
+
+## How the build works
+
+1. Fetches the channel file `https://api.meta.ai/muse-code/channels/muse-stable`.
+2. Reads `manifest_url` and fetches Meta's lookaside manifest.
+3. Downloads the `x86_linux` artifact (`muse-x86-linux`) and checks its **sha256** against the manifest. A mismatch aborts the build.
+4. Assembles an AppDir (`AppRun`, `.desktop`, icon) and runs `appimagetool` (downloaded automatically if not installed).
+
+Environment overrides: `CHANNEL_URL`, `ARTIFACT`, `WORK`, `OUT`, `APPIMAGETOOL`.
+
+## Signing in
+
+On first use run `muse login`. Meta's launcher notes Muse Code availability may be limited
+(e.g. to Meta employees), so your account may be refused even though the download works.
+This packaging doesn't change access; it only wraps Meta's binary.
+
+## Notes
+
+- The AppImage doesn't self-update. Re-run `./build-appimage.sh` to pick up a new release.
+- CI (`.github/workflows/build.yml`) builds weekly and checks `--version`. It does not publish the AppImage.
+
+## License
+
+The scripts, packaging files and artwork here are MIT (see `LICENSE`).
+Muse Code itself is proprietary Meta software under Meta's terms. "Muse" and "Meta" are trademarks of their owners.
@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# Reproducible build of an unofficial Muse Code AppImage for x86_64 Linux.
+# The Muse Code binary is NOT stored in this repo: it is fetched from Meta's
+# official release channel at build time and verified against Meta's sha256 manifest.
+set -euo pipefail
+
+CHANNEL_URL="${CHANNEL_URL:-https://api.meta.ai/muse-code/channels/muse-stable}"
+ARTIFACT="${ARTIFACT:-x86_linux}"          # manifest key for muse-x86-linux
+ARCH=x86_64
+HERE="$(cd "$(dirname "$0")" && pwd)"
+WORK="${WORK:-$HERE/build}"
+OUT="${OUT:-$HERE/Muse-Code-${ARCH}.AppImage}"
+APPIMAGETOOL_URL="${APPIMAGETOOL_URL:-https://github.com/AppImage/appimagetool/releases/download/continuous/appimagetool-x86_64.AppImage}"
+
+need() { command -v "$1" >/dev/null 2>&1 || { echo "missing required tool: $1" >&2; exit 1; }; }
+for t in curl python3 sha256sum; do need "$t"; done
+CURL=(curl --fail --silent --show-error --location --proto '=https' --tlsv1.2 --retry 3)
+
+mkdir -p "$WORK"
+echo "==> channel: $CHANNEL_URL"
+"${CURL[@]}" -o "$WORK/channel.json" "$CHANNEL_URL"
+MANIFEST_URL="$(python3 -c 'import json,sys;print(json.load(open(sys.argv[1]))["manifest_url"])' "$WORK/channel.json")"
+VERSION="$(python3 -c 'import json,sys;print(json.load(open(sys.argv[1]))["version"])' "$WORK/channel.json")"
+echo "==> version: $VERSION"
+"${CURL[@]}" -o "$WORK/manifest.json" "$MANIFEST_URL"
+
+read -r BIN_URL BIN_SHA BIN_SIZE < <(python3 - "$WORK/manifest.json" "$ARTIFACT" <<'PY'
+import json, sys
+m = json.load(open(sys.argv[1]))
+assert m.get("checksum_algorithm") == "sha256", "unexpected checksum algorithm"
+a = m["artifacts"][sys.argv[2]]
+print(a["url"], a["checksum"].lower(), a.get("size", 0))
+PY
+)
+
+BIN="$WORK/muse-x86-linux"
+if [[ -f "$BIN" ]] && echo "$BIN_SHA  $BIN" | sha256sum -c --status; then
+  echo "==> cached binary verified"
+else
+  echo "==> downloading muse-x86-linux (${BIN_SIZE} bytes)"
+  "${CURL[@]}" -o "$BIN.part" "$BIN_URL"
+  mv "$BIN.part" "$BIN"
+fi
+echo "==> verifying sha256 against Meta manifest"
+echo "$BIN_SHA  $BIN" | sha256sum -c - || { echo "CHECKSUM MISMATCH, refusing to package" >&2; rm -f "$BIN"; exit 1; }
+
+echo "==> assembling AppDir"
+APPDIR="$WORK/AppDir"
+rm -rf "$APPDIR"; mkdir -p "$APPDIR/usr/bin" "$APPDIR/usr/share/applications" "$APPDIR/usr/share/icons/hicolor/512x512/apps"
+install -m 0755 "$BIN" "$APPDIR/usr/bin/muse"
+install -m 0755 "$HERE/packaging/AppRun" "$APPDIR/AppRun"
+install -m 0644 "$HERE/packaging/muse-code.desktop" "$APPDIR/muse-code.desktop"
+install -m 0644 "$HERE/packaging/muse-code.desktop" "$APPDIR/usr/share/applications/muse-code.desktop"
+install -m 0644 "$HERE/packaging/muse-code.png" "$APPDIR/muse-code.png"
+install -m 0644 "$HERE/packaging/muse-code.png" "$APPDIR/usr/share/icons/hicolor/512x512/apps/muse-code.png"
+ln -sf muse-code.png "$APPDIR/.DirIcon"
+
+TOOL="${APPIMAGETOOL:-$(command -v appimagetool || true)}"
+if [[ -z "$TOOL" ]]; then
+  TOOL="$WORK/appimagetool"
+  [[ -x "$TOOL" ]] || { "${CURL[@]}" -o "$TOOL" "$APPIMAGETOOL_URL"; chmod +x "$TOOL"; }
+fi
+echo "==> appimagetool"
+ARCH=$ARCH APPIMAGE_EXTRACT_AND_RUN=1 "$TOOL" --no-appstream "$APPDIR" "$OUT"
+echo "==> built $OUT"
+"$OUT" --version
@@ -0,0 +1,15 @@
+#!/bin/bash
+# Run muse directly in a terminal; when launched from a desktop menu (no TTY,
+# no args) open it in Konsole or the system terminal instead.
+HERE="$(dirname "$(readlink -f "$0")")"
+MUSE="$HERE/usr/bin/muse"
+if [ -t 0 ] || [ -t 1 ] || [ "$#" -gt 0 ]; then
+  exec "$MUSE" "$@"
+fi
+if command -v konsole >/dev/null 2>&1; then
+  exec konsole -e "$MUSE"
+elif command -v x-terminal-emulator >/dev/null 2>&1; then
+  exec x-terminal-emulator -e "$MUSE"
+else
+  exec "$MUSE"
+fi
@@ -0,0 +1,10 @@
+[Desktop Entry]
+Type=Application
+Name=Muse Code
+GenericName=AI coding agent
+Comment=Muse Code CLI (unofficial AppImage packaging)
+Exec=muse
+Icon=muse-code
+Terminal=true
+Categories=Development;
+Keywords=muse;ai;agent;cli;