pfx

Got questions or doubts? Ping me on Discord

Built for agents

The command line first, the editor for placing and tuning by hand

pfx new scaffolds a game an agent can work in from its first minute: the project, its content, and an AGENTS.md and CLAUDE.md beside the code. People edit a .pitofx in the editor's inspector or its TOML editor; scripts and agents edit it through the CLI verbs (set and get by dotted key, key, add, remove and the rest), which write the edit and a fresh build back into the .pitofx in one atomic replace. pfx-file.md

After pfx git setup (once per clone), git diff on a .pitofx prints the agent's edit as TOML instead of Binary files differ: the lines it changed. git.md

  1. 01

    An agent writes a .pitofx recipe

    Claude, Codex, Grok or any coding agent edits the recipe through the CLI verbs, by dotted key; each edit writes the change and a fresh build back into the .pitofx in one atomic replace.

    pfx newpfx setpfx getpfx add

    pfx-file.md
  2. 02

    pfx builds and renders

    pfx build runs on the CPU with no clock and no randomness beyond the recipe's seed, so the same recipe gives the same bytes on any machine. The live renderer draws the scene; the path tracer and its denoiser render the stills and clips.

    pfx buildpfx renderpfx clip

    recipe-build.md
  3. 03

    A path-traced film

    pfx film cuts the clips, frame folders and cards into one film, with dissolves, pushes and whips and a true-peak ceiling on the master. The same script, seed and app give the same frames, byte for byte.

    pfx film <script>

    film.md

Build on pfx

pfx is open source under the AGPL-3.0: free for open-source projects, learning and hobby work. Read it, fork it, and send issues and pull requests on GitHub. Closed products and services built on pfx take a licence: free under $200k of yearly revenue plus funding, Indie and Pro above it.

Download pfx 3.1.3 github.com/gmrdad82/pfx docs.pitomd.com/pfx

© Catalin Ilinca, AGPL-3.0-only, with licences for closed products; releases up to 3.1.1 remain MIT. The PITO MD name, the pfx name and its logo are © Catalin Ilinca, all rights reserved.

Every picture and clip on this page is pfx's own, rendered or captured from its neutral scenes and licensed with its code (pfx's NOTICE.md); the pfx gui and game-editor clips were recorded by pfx from its v3.0.1 tag, the terminal clips with prec, the loops encoded with pito-codecs and the charts drawn with pito-compare from the numbers pfx v3.1.2 measures. Type: Exo 2 by NDISCOVER ( SIL Open Font License 1.1 ) and JetBrains Mono by JetBrains ( SIL Open Font License 1.1 ), from pfx's theme.