PieceWork for Linux

Install on Linux

1. Download the AppImage for your processor. To find which one you need, run this command: x86_64 means x64, and aarch64 means arm64.

   uname -m

   Copy

2. Make the AppImage executable.

   chmod +x PieceWork-*.AppImage

   Copy

3. Run it. On the first start, PieceWork adds itself to your app launcher, so that piecework:// links open it.

   ./PieceWork-*.AppImage

   Copy

4. Connect a provider, such as Codex with your ChatGPT plan or Claude Code with your Claude plan. Then describe the agent you want in one prompt and save it.

Ubuntu 23.10 or newer, and Debian 13

1. These distributions restrict the user namespaces that the Electron sandbox needs, so PieceWork exits during launch until you install its AppArmor profile. Take the profile out of the AppImage:

   ./PieceWork-*.AppImage --appimage-extract resources/linux/piecework.apparmor

   Copy

2. Install the profile, then reload AppArmor:

   sudo install -m 0644 squashfs-root/resources/linux/piecework.apparmor /etc/apparmor.d/piecework
   sudo systemctl reload apparmor

   Copy

3. The profile applies to an AppImage in ~/Applications, ~/Desktop, ~/Downloads, ~/.local/bin or /opt/PieceWork. Keep it in one of these, or edit the path in the profile before you install it. Do not start PieceWork with --no-sandbox: the sandbox is the boundary between a web page and the rest of your computer.

Good to know

• Each release is tested on Ubuntu 24.04 on x64. PieceWork also runs on Ubuntu 26.04.
• PieceWork checks for new versions and updates itself.
• The AI provider you choose needs an internet connection. A local model needs none.
• Remote desktop works with the x64 AppImage in an X11 session, such as Xorg or Xvfb. It does not work under Wayland, and the arm64 AppImage does not include it.

Questions

Other systems