UX: plugin interface documentation

[smlx]

What were you trying to do

I'm interested in writing an age plugin along similar lines to age-plugin-yubikey.

What happened

I searched but couldn't find any documentation on the plugin interface exposed by rage (and age at some point I guess).

It is possible to read the code and play around with age-plugin-yubikey to figure out how to implement an equivalent interface, but I wondered: is there any documentation on the plugin executable interface? For example: which commands or flags are required? which are optional? what are their arguments? what do they return? etc.

Does any documentation along those lines exist?

[str4d]

Yes! I'd been developing the age plugin spec in a HackMD, but it has now been moved to here: C2SP/C2SP#5 (and once that is merged, https://c2sp.org/age-plugin).

I also implemented the age-plugin Rust crate (which this plugin uses), which handles all the IPC logic, so all you need to implement is the plugin logic.