Moment

Moment

@moment.dev

Moment is a powerful, modern docs platform, based entirely on Markdown files that are stored locally on your device.

61 followers31 following35 posts

As a company, we @moment_dev have a single ambition: to make it possible to run your entire business out of a Markdown file.

View full thread

And it has to be fundamentally backed by git (though, actually, we use jj as the frontend 😇):

As a company, we @moment_dev have a single ambition: to make it possible to run your entire business out of a Markdown file.

View full thread

The very best agents are coding agents (like `claude`), so they to be fundamentally programmable. Here, you can see it running in our embedded terminal below:

And you have to be able to request data from API. We built a Postman-like API client (well, ok, it's Yaak-like, since we think Yaak is much better) to help users quickly build requests up to use them in their docs:

As a company, we @moment_dev have a single ambition: to make it possible to run your entire business out of a Markdown file.

View full thread

So what did we launch? Here is a taste. To be truly applicable in team settings, Markdown files can't just be Markdown files. They have to be fundamentally collaborative:

As a company, we @moment_dev have a single ambition: to make it possible to run your entire business out of a Markdown file.

A Markdown file, really? Yes. Finance people have Excel, lawyers have Word, PMs have Notion. But all of these technologies were built in an era when software was expensive and extremely hard to customize. But that isn't true anymore. The best agents in the world are coding agents—claude, codex, etc.

They are good enough that a child can materialize an NES emulator directly out of the ether. We know because we've done it:

🧵 Changelog 0008. Daily Notes. One of Moment’s most-requested features. The button always shows up in the top left of the docs list. Click it, and it creates a page for today, if one does not exist. The cal shows you which dates have entries. Click to open that date's page!

View full thread

Beyond all this, many small bugs and fixes. Forward/backwards buttons, fixes to how delete works next to bullet list, fixes for truncation, decoding, and zombie process bugs in the embedded terminal, fixes to filewatching, fixes for image loading, and many others.

🧵 Changelog 0008. Daily Notes. One of Moment’s most-requested features. The button always shows up in the top left of the docs list. Click it, and it creates a page for today, if one does not exist. The cal shows you which dates have entries. Click to open that date's page!

View full thread

To support saner auth stories, we've taught Moment about `.env` files! Make a file per env (`staging.env`, `prod.env`, etc.), put creds in them, use them in `request` pages! Here we have a `GITHUB_TOKEN` in an `.env` file. We reference it as `{{env.GITHUB_TOKEN}}` in the req.

This last feature is a little nascent: you can now invoke requests from Markdown pages. `request` pages provide a button to copy the request as a code cell, but really, the utility is that you'll be able to use agent TUIs like `claude` and `amp` to make UI out of it. As here:

🧵 Changelog 0008. Daily Notes. One of Moment’s most-requested features. The button always shows up in the top left of the docs list. Click it, and it creates a page for today, if one does not exist. The cal shows you which dates have entries. Click to open that date's page!

Moment aims to blur the line between knowledge bases and internal tools. To do this, it needs to be easy to build and make network requests. As of this week, `request` pages (Postman-ish, or like a watered-down Yaak) support all of Kubernetes auth. Yes, all of it.

Collaborative editing with agents is coming (and also is really really hard to build)

Alex Clemmer@hausdorff.bsky.social

🧵 Collab editing with AI is really, really hard. Some day I will fully internalize that nothing in text editing is ever truly solved. Like alcoholism, it's a problem that never really goes away. A tumble-dryer that exclusively outputs mismatched socks/other off-by-one errors.

Changelog 0007: Branches. So you can imbue any git repo that contains `.md` files with Google-Docs-like collaboration features, instantly, by adding a `moment.yml` file to it. But git repos have branches. So this week we decided to support them too. 🧵

A simple-looking feature. Fractally complex in practice. To avoid getting paged while the chestnuts are on the open fire, we tried to strike a balance between simplicity and utility. So it is sparing in its functionality for now. We do support simple merge/conflict resolution.

Changelog 6. Starting now, in a couple clicks, you can turn any git repo with .md files into a live-collaborative doc by adding a `moment.yml` to the root. The desktop app does it for you in 3 clicks. Here, we import kube-prom runbooks and run a shell command in 5 clicks. 🧵

Changelog 2 is out. 🧵 One of our long-term goals is to blur the line between knowledge bases (Confluence, Notion, wikis) and internal tools. To do this you need to be able to get data. To visualize, to manipulate, etc. Thus, a Postman-style API client:

View full thread

Right now, this feature is useful only as a very, very simple standalone Postman competitor. In the future, it will be the basis of rich internal tools. Live dashboards, line-of-business apps, release tools... anything you like.

Changelog 2 is out. 🧵 One of our long-term goals is to blur the line between knowledge bases (Confluence, Notion, wikis) and internal tools. To do this you need to be able to get data. To visualize, to manipulate, etc. Thus, a Postman-style API client:

Ok ok, it's a Yaak-style API client. But, you know, without all the features. The idea is: type in a URL, specify headers, params, and a body, and click the Send button. You receive a response. Or, you can paste a cURL command to autopopulate all of these things.

View full thread

And that is why we've started giving talks about it! You can see the @cascadiajs.com one here: bsky.app/profile/casc...

CascadiaJS@cascadiajs.com

You want to ship a Linear-like experience, so you install some CRDT libraries and expect things to Just Work™. @hausdorff.bsky.social of moment.dev digs into why this isn't that simple. www.youtube.com/watch?v=OGJx... Subscribe to get notified when we ship more videos from #CascadiaJS 2025! 📺

And, finally, lots and lots and LOTS of bug fixes. Mostly reported by community, mostly to do with the fenced code block. Thank you to the community!

Collaborative text editing. Also very straightforward. Sometimes you want to collaboratively edit a document. It turns out, though, it's less straightforward to get a text editor to run at 60fps even with a lot of editors...

You are up to date.