# Option to run in headless mode

**URL:** <https://forum.pixieditor.net/t/option-to-run-in-headless-mode/557>\
**Category:** Proposals\
**Tags:** proposal\
**Created:** [February 14, 2026, 5:15pm UTC](https://forum.pixieditor.net/t/option-to-run-in-headless-mode/557 "2026-02-14T17:15:12Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![mengusfungus](https://forum.pixieditor.net/letter_avatar_proxy/v4/letter/m/5daacb/32.png) [@mengusfungus](https://forum.pixieditor.net/u/mengusfungus)\
**Post date:** [February 14, 2026, 5:15pm UTC](https://forum.pixieditor.net/t/option-to-run-in-headless-mode/557/1 "2026-02-14T17:15:12Z")

</div>

A great use case for procedural image generators is as part of an automated pipeline for generating assets in bulk (for example variations on particles or foliage). To make such workflows viable we need to be able to run the editor in command line mode, invokable from shell scripts or other external tooling, while varying various parameters to create outputs without manual edits.

Specifically two features need to be added in tandem:

1. A ‘command line argument node’ in the node editor which takes its values from command line arguments, with a default in-editor value which can be fed into, for example, noise seeds. Various types could be supported, simple float values would already go a long way here. But it would be ideal to support, say, path arguments for loading images as well.
2. Command line arguments which will simply run a .pixi pipeline and produce an output without launching the editor application. Users would run the executable with -input [.pixi] -output [.png] -arg [argname] [argval] command line options.

---

<div class="post-metadata">

**Author:** ![flabbet](https://forum.pixieditor.net/user_avatar/forum.pixieditor.net/flabbet/32/6_2.png) [@flabbet](https://forum.pixieditor.net/u/flabbet)\
**Post date:** [February 14, 2026, 5:16pm UTC](https://forum.pixieditor.net/t/option-to-run-in-headless-mode/557/2 "2026-02-14T17:16:02Z")

</div>

Proposal status: `open-for-discussion`  
Discussion ends: `tbd`

---

<div class="post-metadata">

**Author:** ![flabbet](https://forum.pixieditor.net/user_avatar/forum.pixieditor.net/flabbet/32/6_2.png) [@flabbet](https://forum.pixieditor.net/u/flabbet)\
**Post date:** [February 14, 2026, 5:19pm UTC](https://forum.pixieditor.net/t/option-to-run-in-headless-mode/557/3 "2026-02-14T17:19:26Z")

</div>

Thank you for your proposal, it seems like demand for CLI mode is definitely there as this topic keeps coming back.

One thing for command line argument mode. I believe manually constructing graphs in CLI can be hard to do. It am afraid that would create long chains of barely understandable commands. Unless you have a good idea how it could look

---

<div class="post-metadata">

**Author:** ![mengusfungus](https://forum.pixieditor.net/letter_avatar_proxy/v4/letter/m/5daacb/32.png) [@mengusfungus](https://forum.pixieditor.net/u/mengusfungus)\
**Post date:** [February 15, 2026, 12:28am UTC](https://forum.pixieditor.net/t/option-to-run-in-headless-mode/557/4 "2026-02-15T00:28:06Z")

</div>

I agree with that, which is why I think the CLI only need expose values on existing nodes (defined through the editor GUI) and not actual adding or removing of nodes or otherwise changing graph topology in any way.

A very simple workflow would be something like creating a graph in the editor:

CLI Variable Node (name: “seed” type: scalar) → Noise Node → Shader Node → Output

And the user would run a command like `./pixi -in myfile.pixi -out myfile.png -arg seed 12345`

---

<div class="post-metadata">

**Author:** ![mengusfungus](https://forum.pixieditor.net/letter_avatar_proxy/v4/letter/m/5daacb/32.png) [@mengusfungus](https://forum.pixieditor.net/u/mengusfungus)\
**Post date:** [February 15, 2026, 12:31am UTC](https://forum.pixieditor.net/t/option-to-run-in-headless-mode/557/5 "2026-02-15T00:31:30Z")

</div>

I do think there could be a world where you could define graphs in a human readable format (xml / json) and have have ways of importing / exporting to and from .pixi as well as running such pipelines from the CLI. That would open up a lot of possiblities for external tool development but I think the scope is large enough to be a separate proposal.

---

<div class="post-metadata">

**Author:** ![flabbet](https://forum.pixieditor.net/user_avatar/forum.pixieditor.net/flabbet/32/6_2.png) [@flabbet](https://forum.pixieditor.net/u/flabbet)\
**Post date:** [February 15, 2026, 9:33am UTC](https://forum.pixieditor.net/t/option-to-run-in-headless-mode/557/6 "2026-02-15T09:33:50Z")

</div>

Ah, this makes more sense now. Instead of using custom CLI variable node, we can leverage blackboard, which is currently on development version. It would open a possibility to overwrite any argument for any .pixi file, which originally wasn’t made for CLI
