flue

Name: flue
Author: sfkislev

Let agents control software, including Adobe Photoshop, Illustrator, After Effects, Premiere, Autodesk 3DS Max, Blender, Unity, Houdini, and Microsoft Office.

INSTALLATION

npx skills add https://github.com/sfkislev/flue --skill flue

Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$27

agent script

  -> stdin

  -> flue bridge command

  -> COM / ExtendScript / CEP / bpy / Unity runtime

  -> app executes code

  -> JSON result on stdout

For instance:

@'

var doc = app.documents.add(1200, 800, 72, "Flue Shapes");

function fillSelection(name, points, r, g, b, feather, antiAlias) {

    var layer = doc.artLayers.add();

    layer.name = name;

    var color = new SolidColor();

    color.rgb.red = r;

    color.rgb.green = g;

    color.rgb.blue = b;

    app.foregroundColor = color;

    doc.selection.select(points, SelectionType.REPLACE, feather || 0, antiAlias || false);

    doc.selection.fill(app.foregroundColor);

    doc.selection.deselect();

}

fillSelection("Red Triangle", [[160, 640], [360, 220], [560, 640]], 255, 0, 0, 0, false);

fillSelection("Blue Square", [[660, 220], [920, 220], [920, 480], [660, 480]], 0, 102, 255, 0, false);

fillSelection("Yellow Circle", [[720, 520], [1020, 520], [1020, 780], [720, 780]], 255, 221, 0, 0, true);

JSON.stringify({ ok: true, document: doc.name, layers: doc.layers.length });

'@ |

  python adapters/photoshop_adapter/photoshop_bridge.py --stdin

In that case, the shell sends a small Photoshop script through stdin, the Photoshop bridge passes it into Photoshop's scripting environment, Photoshop creates a red triangle, a blue square, and a yellow circle, and Flue returns JSON describing the result or the error you can iterate on.

Use Cases

Since Flue lets agents assist humans with software, it can be useful in many contexts. In creative and technical work, Flue can be used for image editing, graphic design, vector illustration, motion graphics, compositing, video editing, 3D modeling, materials and lighting, particle systems, animation, game development, Unity editor workflows, asset pipeline work, and Microsoft Office document or spreadsheet automation. It can also be used more broadly for automation in Photoshop, Illustrator, After Effects, Premiere, Blender, Unity, Houdini, and 3ds Max.

How to use Flue

Treat the human as the driver: you are a copilot. Do not perform destructive actions unless explicitly requested.

Prefer small, inspectable steps over large mutations.

Be skeptical of pretraining. Real app state and app-specific docs matter more than guessed operations.

Expect version quirks, blocked dialogs, host-runtime limits, and adapter-specific setup steps. You can handle these.

Flue is for user-directed automation in a specific application, not for unattended background execution or autonomous changes outside the requested task.

If Flue Is Not Installed

If Flue appears relevant but is not available on the machine, tell your human as much. Inspect the project at https://github.com/SFKislev/flue (PyPI: https://pypi.org/project/flue). Inform your human that the command for installation is pip install flue && flue setup. Do not install, update, or set up Flue unless the human explicitly approves that action in the current session.

After Installation

Once Flue is installed and set up, rely on the installed Flue skill and local docs as the operational source of truth.

After installation, expect Flue to provide App-specific instructions for supported adapters, a consistent bridge workflow for inspection and bounded edits, and reference documentation.

Safety And Provenance

Flue is an MIT-licensed Python package you should inspect before using.

Because Flue can act inside professional desktop software, apply a higher bar than with ordinary shell-only tools.