PeerBrush Source
Free & open source / GPL v3 / In active development

PeerBrush

Image editing with layers, masks and connected AI agents.

Choose a download Watch the trailer

PeerBrush 0.30.1 · macOS, Linux & Windows

Free to download and useGPL v3 license
The real PeerBrush window editing a mountain lake at golden hour. Layers for Sunlight, Lake reflection, Atmosphere, Sun glow, Sky and Photo; the status bar shows MCP connected and the AI updating the shared canvas.
VIDEO

Trailer

ONGOING DEVELOPMENT

Artists and developers:
take part in PeerBrush.

Try a workflow, share what needs improving, or contribute a focused change. The application and its source are free under GPL v3.

Artists

Test painting, masks or layer editing. Share artwork, awkward steps and the tools your workflow is missing.

Join the conversation

Developers

Contribute Rust, egui, wgpu, codecs, tests or native platform fixes. Start with the development guide and a small, reviewable change.

Development guide
SHARED DOCUMENT

You and an agent, editing at the same time

  1. One open document, two editors

    While you paint, a connected agent edits the same document. Both changes land in one shared history, marked by who made them.

  2. Different parts of the canvas

    An agent can reserve a whole layer or only a region of one, so you can keep working everywhere else, even on the same layer. Its work area is outlined in blue.

  3. Different layers

    In the trailer edit, the agent built the sky, grade, glow, atmosphere and lake light on its own layers while the sunlight and dodge & burn were painted on separate manual layers.

  4. Still editable

    Nothing is merged. Turn any layer off and on; masks, effects and blend modes survive the saved PSD.

Painting

Pressure, texture, taper and flow. Brush, erase, clone and heal.

Layers & masks

Folders, blend modes, selections and separate color and mask editing.

Editable effects

Curves, levels, color balance, bloom and liquify with live previews.

8 & 16 bit

Native channel precision through editing, transforms and PSD / PNG saves.

DOWNLOADS

Choose your platform

PeerBrush 0.30.1 · Stable

Free native downloads. Each release includes its matching GPL v3 source and third-party notices.

Windows

x64 · Microsoft Store · Package 1.30.1.0

Version 0.30.1Microsoft Store

Linux

amd64 · Ubuntu 24.04 DEB · Manual updates

31.6 MBDownload

macOS

Apple silicon · arm64 · Developer ID signed, notarized and stapled

66.0 MBDownload

PeerBrush 0.30.1 is available for Apple silicon Macs, Ubuntu 24.04 amd64, and Windows x64. The Microsoft Store offers Windows package 1.30.1.0. Unsupported Photoshop structures remain read-only.

Release notes All release notes & documentation
VERSION HISTORY

Published releases

    See all versions & documentation
    AI CONNECTION

    Connect an agent

    Agents inspect the actual canvas and edit through the same document engine. AI changes appear in blue.

    Codex · Claude Desktop · Cursor · Gemini CLI

    MCP setup and tool reference
    The PeerBrush status bar showing MCP connected next to the Connect AI button.
    The real status bar once a client is attached
    1. 01

      Click Connect AI in PeerBrush

      The app registers with detected clients and preserves their existing settings.

    2. 02

      Reload your AI client

      Approve the connection if prompted. A green MCP indicator in PeerBrush confirms a connected client.

    peerbrush_edit
    {"commands":[{"op":"paint","layer":"LAYER_ID",
  "points":[[60,60],[180,120]],"radius":14,
  "color":[233,84,32,255]}],
 "expected_revision":0,"actor":"my-agent",
 "label":"Paint orange accent"}

    Choose your model in the AI client. PeerBrush is free; separate AI providers may charge for their services.

    FILE SUPPORT

    Supported formats

    Compatibility details
    FormatCurrent supportBehavior
    PSD v1 · RGB · 8 / 16 bitEditable, supported structuresRaster layers, groups, supported blends and raster masks. Saves include a current merged composite.
    PNG 8 / 16 bitImport & exportExport retains the document’s native channel depth.
    JPEG / BMP / GIF / TIFF / WebP / ICO / Netpbm / TGA / QOIImage importSupported static images, with explicit frame, page or icon choices where needed. Supported native 16-bit samples retain their precision.
    SVG / SVGZEditable vector importSupported self-contained static artwork. Outline text; unsupported visual features are rejected. Vector coverage renders at 8 bit.
    RGB ICC profilesBounded color managementMatrix/TRC and classic RGB LUT profiles. Supported image imports normalize to sRGB at source depth; protected PSDs require an explicit editable copy.
    Unsupported PSD structuresProtected previewRead-only merged preview. An explicit flattened copy retains the original precision.
    PSB / other color modesNot supportedCMYK, HDR/32-bit, broader Photoshop layer styles and newer ICC LUT structures remain unsupported. Supported RGB PSB sources retain native 8/16-bit precision.
    QUICK REFERENCE

    Canvas shortcuts

    Paint
    B
    Move / rotate / scale
    WER
    Frame canvas or selection
    F
    Pan
    Middle drag / Space + drag
    Zoom
    Scroll / Alt + right drag
    Delete selected layers
    DEL
    Duplicate layer selection
    Ctrl + D
    Group / merge layers
    Ctrl + G / Ctrl + Shift + G
    Undo / redo
    Ctrl + Z / Ctrl + Shift + Z
    SOURCE

    Develop from source

    Rust, egui and wgpu. Licensed under GPL v3.

    git clone https://github.com/Deftr0y/PeerBrush.git
cd PeerBrush
cargo run --locked

    Native build and automated tests pass on Windows, Linux and macOS. Desktop workflow verification on Linux and macOS is pending.

    Development guide
    Native workspace