Skip to content

Pine Drama Studio 0.3.0

Latest

Choose a tag to compare

@SitgesRun SitgesRun released this 16 Nov 08:18
· 1 commit to main since this release

Pine Drama Studio 0.3.0

This version uses a new project format (protocol major 2). It needs Pine Computer as updated on November 16, 2026 (drama-cli 0.8.1). Earlier Studios no longer work with Pine Computer, so everyone must update.

Before you update

  • Finish or stop every running turn in 0.2.6 first. Chats from 0.2.6 do not carry over: on first start, 0.3.0 moves their history aside and says where. Your work is in your project folder (#252).

Projects made with 0.2.x

  • Open the old project folder in 0.3.0. The Project view says "This project was made by an earlier Pine Drama Studio" and offers Convert This Project…. You can also run the command Pine: Convert Project from an Earlier Studio (#174, #227).
  • Choose Back Up and Convert. The Studio first copies the folder beside itself as <name>.backup-<date> (the UTC date), or the next free name, which Studio 0.2.6 still opens. Then it converts the folder in place, and the project opens (#258).
  • Each card keeps the version it showed. Earlier versions stay in the backup (#227). Stored prompts are not carried, since every prompt is composed when drawn; a character's outfit and a prop's printed words join its description (#263).
  • The conversion changes nothing when the project has no record of its turns. Open the project once in Studio 0.2.6, then convert.
  • Turns or paid calls left unsettled in 0.2.6 can't be recovered after converting. The Studio names each one when it converts, and Pine may already have charged for them (#258).
  • If a conversion was cut off, put the backup back in the folder's place and convert again.

The project folder

  • A project is a folder with one folder per object and its current file. Its history is a git repository inside the folder, so every result that came into the project stays one restore away (#145, #159, #173).
  • Use brings an object back as it was at an earlier result: its files then, receipts with them, and the files it did not hold then removed, in that object's own folder (#178, #179, #180, #263, #264, #265).
  • Your own edits are kept. A file you edit by hand is recorded in history before a turn's result replaces it. A file only you changed stays as you left it (#237, #249).
  • The Studio brings its own git. Nothing else needs to be installed (#143).

Turns

  • Results come into your project while Pine Computer works, about every 15 seconds. Each collection that changes files is its own entry in history (#249).
  • A card not drawn yet says when it is being made, while Pine Computer's records hold a paid call for it (#230).
  • Stop cancels the turn on Pine. What the turn changed before the Stop still lands while the Computer still has it (#194, #212).
  • A failed try at bringing results in is repeated in full. The next one brings in everything Pine Computer had sent, a file that was changed and then restored included (#249).
  • A file your project cannot hold is named, with why, and the rest of the result lands (#223, #240).
  • A turn still running when 0.3.0 restarts or updates is followed to its end (#239, #252).

Chats

  • Every Chat of a project works the same way. There is no Project Chat role and no Start Episode, and several Chats may work on one episode (#224, #232, #233).
  • Approvals are questions in the Chat. The separate review side is gone, and takes no longer show Approved or Waiting for review (#186).
  • File names in a Chat's answer are plain text, not links (#191).
  • A finished session no longer shows its last progress in the Sessions list (#142).

Project view and canvas

  • One text per card. An asset is drawn from its description, which you edit; its full prompt shows read only. A keyframe, storyboard or take may have its own prompt, which the agent writes when you ask; Use the automatic prompt removes it (#263).
  • Versions lists each result with its date and who made it. To bring one back, use the card's Use (#173, #180).
  • Canvas lines show what the next draw of a card will send (#169).
  • Episodes lists the episodes your bible lists, also in a new project (#236).
  • An episode under 1. Script is labelled by its furthest stage that shows a file (#113).
  • The canvas composer stays inside a narrow pane, clear of the minimap (#128).

Known issue

  • If you press Stop right as Pine Computer asks you a question, the Chat may keep showing that it waits for you and not take your message. Run Developer: Reload Window (#257).

Requirements

  • macOS on Apple silicon or Intel.
  • A Pine project key (pk_…) from pinecomputer.io.
  • Pine Computer as updated on November 16, 2026 (drama-cli 0.8.1).

Install

Download the .dmg for your Mac: darwin-arm64 for Apple silicon, darwin-x64 for Intel. Open it and drag Pine Drama Studio to Applications. Both builds are signed and notarized by Apple. To check the downloads, run shasum -a 256 -c SHA256SUMS. The .zip files are what the app downloads when it updates itself. Studio 0.2.6 offers this update by itself.

For developers: protocol major 2 (doc/protocol.md); Pine Computer runs drama-cli 0.8.1; architecture and quick start: #248.

Questions and help: Discord.