Hacker News Reader

Comment by ellieh | Hacker News Reader

Hello! Atuin maintainer here

Happy to answer any questions

Is the format human readable? Let's say I am on a foreign machine where I do not have Atuin desktop installed, could I trivially copy and paste from this run book (ignoring templating)? Or would I need some kind of export step to dump the commands? It made references to committing to source control, so I assume it must be something diffable, but I could not find an example raw file.

copy-paste of another comment but I think it answers everything here! The only addition I'll add is that if you copy-paste into another Atuin instance, the richness is preserved. If you copy paste to anything else, it'll be pasted as markdown.

---

The runbook files are just YAML (for now). They're more verbose than I'd like, but do convey a lot of information - both rich text and executable.

There's an example here: https://github.com/atuinsh/desktop/blob/8ebed35d7efe68a92363...

I'm aware this isn't ideal, and longer term we want something that looks much more like markdown. A key requirement for us here is that it's easy + convenient to type - just like normal markdown - so putting everything as a code block annotation isn't ideal.

The current sketch of what that could be looks like this: https://forum.atuin.sh/t/desktop-devlog-markdown-vim-local-f...

Would love to know if you have any thoughts!

Oof, not pretty, but I guess it gets the job done (although I am always rooting for my dark horse, TOML). I suppose I could technically grep for `code` if I were in a bind.

any way I could use the desktop app to run my runbooks in my remote servers?

Mostly - we have ssh blocks that cause the subsequent shell and terminals blocks to run remotely

We don’t yet support full remote execution, but should do soon!

Reply on news.ycombinator.com