Make sure Linux works

[idofrizler]

Goal

Ensure Cooper works on Linux and create distributable packages.

Priority

P2 - Platform support - 4-6 hours

Implementation Details

1. Test Build on Linux

Set up Linux environment (VM or GitHub Actions):

• Test npm install
• Test npm run build
• Fix any node-pty or native module issues

2. Common Linux Issues

• node-pty compilation: needs build-essential, python3
• Electron sandbox: may need --no-sandbox flag
• File permissions

3. Create Linux Packages

Add to electron-builder config:

linux target: AppImage, deb
category: Development

4. Update CI

Add Linux to build matrix in GitHub Actions.

Files to Modify

• package.json (electron-builder config)
• .github/workflows/ (CI for Linux)
• README.md (Linux prerequisites)

Prerequisites for Linux Users

• Node.js 18+
• build-essential: sudo apt install build-essential
• Python 3: sudo apt install python3

Acceptance Criteria

• npm install succeeds on Ubuntu 22.04+
• npm run build succeeds
• AppImage runs correctly
• Added to CI build matrix

[maxtara]

ran cooper on WSL. Not too much to add to developer instructions, though I'm not entirely sure what people usually write for Linux/wsl instructions.

Only thing I needed to do was ldd node_modules/electron/dist/electron | grep "not found"
and post the results into copilot to explain what library was missing (it was only libnss3).

Though my WSL is highly modified. I'll create a fresh WSL to test next.

TODO:

• create a fresh WSL to test
• create dependency script, work out what to include from electron docs. At very least it'll be libnss3.
• Add dist
• Add a single non ubuntu distro, whatever is easiest in Fedora/CentOS/Rocky I think
• build dist in these pipelines. Ensure that appropriately tests the dependencies (like libnss3)