<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
    <title>writui - Blog</title>
    <subtitle>A writing app for the terminal. No nonsense. Markdown. Local. Encrypted.</subtitle>
    <link rel="self" type="application/atom+xml" href="https://writui.aak.sh/blog/atom.xml"/>
    <link rel="alternate" type="text/html" href="https://writui.aak.sh/blog/"/>
    <generator uri="https://www.getzola.org/">Zola</generator>
    <updated>2026-10-13T00:00:00+00:00</updated>
    <id>https://writui.aak.sh/blog/atom.xml</id>
    <entry xml:lang="en">
        <title>Try a five-minute writing session</title>
        <published>2026-10-13T00:00:00+00:00</published>
        <updated>2026-10-13T00:00:00+00:00</updated>
        
        <author>
          <name>Unknown</name>
        </author>
        
        <link rel="alternate" type="text/html" href="https://writui.aak.sh/blog/try-a-five-minute-writing-session/"/>
        <id>https://writui.aak.sh/blog/try-a-five-minute-writing-session/</id>
        
        <content type="html" xml:base="https://writui.aak.sh/blog/try-a-five-minute-writing-session/">&lt;p&gt;Let’s write your first post in writui. You’ll choose a password, put a few
thoughts on the page, and save a version to come back to. Here are the steps
we’ll follow:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href=&quot;https://writui.aak.sh/blog/try-a-five-minute-writing-session/#1-install-and-open-writui&quot;&gt;Install and open writui&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://writui.aak.sh/blog/try-a-five-minute-writing-session/#2-choose-your-password&quot;&gt;Choose your password&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://writui.aak.sh/blog/try-a-five-minute-writing-session/#3-start-a-post&quot;&gt;Start a post&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://writui.aak.sh/blog/try-a-five-minute-writing-session/#4-write-a-few-thoughts&quot;&gt;Write a few thoughts&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://writui.aak.sh/blog/try-a-five-minute-writing-session/#5-keep-a-version&quot;&gt;Keep a version&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://writui.aak.sh/blog/try-a-five-minute-writing-session/#6-come-back-to-it&quot;&gt;Come back to it&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;1-install-and-open-writui&quot;&gt;1. Install and open writui&lt;/h2&gt;
&lt;p&gt;On macOS or Linux, paste this into your terminal and press Enter:&lt;/p&gt;
&lt;pre&gt;&lt;code data-lang=&quot;sh&quot;&gt;curl -fsSL https://writui.aak.sh/install.sh | bash
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Follow any instructions the installer prints, then open the app:&lt;/p&gt;
&lt;pre&gt;&lt;code data-lang=&quot;sh&quot;&gt;writui
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;On Windows, follow the &lt;a rel=&quot;external&quot; href=&quot;https://github.com/aakashns/aak.sh/tree/main/writui#windows&quot;&gt;build instructions&lt;/a&gt;
first, then run &lt;code&gt;writui&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&quot;2-choose-your-password&quot;&gt;2. Choose your password&lt;/h2&gt;
&lt;p&gt;The first time you open writui, it asks you to create your vault. This is
where your posts and their versions are kept, encrypted on your computer.&lt;/p&gt;
&lt;p&gt;Type a password of at least eight characters, press Tab, and type it again
in &lt;strong&gt;Confirm password&lt;/strong&gt;. Press Enter to create your vault. You can also
click either password box to move between them.&lt;/p&gt;
&lt;p&gt;&lt;a target=&quot;_blank&quot; rel=&quot;noopener&quot; href=&quot;/blog/first-session/create-vault.webp&quot;&gt;&lt;img class=&quot;terminal-screenshot&quot; src=&quot;/blog/first-session/create-vault.webp&quot; alt=&quot;The Create your vault screen with Password and Confirm password fields&quot; width=&quot;1000&quot; height=&quot;360&quot; loading=&quot;eager&quot; decoding=&quot;async&quot;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Choose a password you can remember or keep in your password manager.
&lt;strong&gt;There is no password recovery:&lt;/strong&gt; forgetting it means losing access to
your writing. If you’ve already set up writui, enter your existing password
to unlock it instead.&lt;/p&gt;
&lt;h2 id=&quot;3-start-a-post&quot;&gt;3. Start a post&lt;/h2&gt;
&lt;p&gt;You’ll see your list of posts. Click &lt;strong&gt;New&lt;/strong&gt; or press &lt;code&gt;n&lt;/code&gt; to start writing.&lt;/p&gt;
&lt;p&gt;&lt;a target=&quot;_blank&quot; rel=&quot;noopener&quot; href=&quot;/blog/first-session/new-post.webp&quot;&gt;&lt;img class=&quot;terminal-screenshot&quot; src=&quot;/blog/first-session/new-post.webp&quot; alt=&quot;The empty post list, with New highlighted above Import and the search field&quot; width=&quot;1000&quot; height=&quot;300&quot; loading=&quot;eager&quot; decoding=&quot;async&quot;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;The first line already starts with &lt;code&gt;# &lt;/code&gt;. Type a title, such as
&lt;strong&gt;A little room to think&lt;/strong&gt;, then press Enter twice to leave a blank line
before the body.&lt;/p&gt;
&lt;h2 id=&quot;4-write-a-few-thoughts&quot;&gt;4. Write a few thoughts&lt;/h2&gt;
&lt;p&gt;Write about something on your mind. Or try this short example to see how
Markdown looks:&lt;/p&gt;
&lt;div class=&quot;command writing-example&quot;&gt;
&lt;button type=&quot;button&quot; class=&quot;copy&quot; data-copy=&quot;writing-example&quot; aria-live=&quot;polite&quot; hidden&gt;Copy&lt;/button&gt;
&lt;pre&gt;&lt;code id=&quot;writing-example&quot;&gt;Today I want to make a little room for **writing**.

## Things worth noticing

- A good conversation
- An idea for tomorrow
- A sentence I want to keep

One quiet paragraph is a good start.&lt;/code&gt;&lt;/pre&gt;
&lt;/div&gt;
&lt;p&gt;&lt;a target=&quot;_blank&quot; rel=&quot;noopener&quot; href=&quot;/blog/first-session/writing.webp&quot;&gt;&lt;img class=&quot;terminal-screenshot&quot; src=&quot;/blog/first-session/writing.webp&quot; alt=&quot;A post titled A little room to think with a bold word, a heading, and a list&quot; width=&quot;1000&quot; height=&quot;350&quot; loading=&quot;eager&quot; decoding=&quot;async&quot;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;The text is formatted as you type: &lt;code&gt;**writing**&lt;/code&gt; becomes bold, &lt;code&gt;##&lt;/code&gt; starts a
heading, and &lt;code&gt;-&lt;/code&gt; starts a list. The Markdown marks stay visible, so you can
always see and edit what you typed.&lt;/p&gt;
&lt;p&gt;Your post &lt;strong&gt;saves automatically as you write&lt;/strong&gt;. You don’t need to press a
save button to keep your changes.&lt;/p&gt;
&lt;h2 id=&quot;5-keep-a-version&quot;&gt;5. Keep a version&lt;/h2&gt;
&lt;p&gt;Press Ctrl+K to open the menu. It lists the commands and their shortcuts.
You can click a command, move to it with the arrow keys and press Enter,
or type part of its name to find it.&lt;/p&gt;
&lt;p&gt;&lt;a target=&quot;_blank&quot; rel=&quot;noopener&quot; href=&quot;/blog/first-session/menu.webp&quot;&gt;&lt;img class=&quot;terminal-screenshot&quot; src=&quot;/blog/first-session/menu.webp&quot; alt=&quot;The command menu showing Save version, History, Export as markdown, and other commands&quot; width=&quot;1000&quot; height=&quot;600&quot; loading=&quot;eager&quot; decoding=&quot;async&quot;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Choose &lt;strong&gt;Save version&lt;/strong&gt;, or close the menu with Esc and press Ctrl+S.
Name the version &lt;strong&gt;First thoughts&lt;/strong&gt;, then press Enter.&lt;/p&gt;
&lt;p&gt;&lt;a target=&quot;_blank&quot; rel=&quot;noopener&quot; href=&quot;/blog/first-session/save-version.webp&quot;&gt;&lt;img class=&quot;terminal-screenshot&quot; src=&quot;/blog/first-session/save-version.webp&quot; alt=&quot;The Save version dialog with First thoughts entered as the version name&quot; width=&quot;800&quot; height=&quot;260&quot; loading=&quot;eager&quot; decoding=&quot;async&quot;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;A version keeps a snapshot of your post. It’s useful when you want to
try a different direction without losing the earlier one. Open &lt;strong&gt;History&lt;/strong&gt;
from the menu, or press Ctrl+R, to see the version you just saved. Press
Esc to return to writing.&lt;/p&gt;
&lt;h2 id=&quot;6-come-back-to-it&quot;&gt;6. Come back to it&lt;/h2&gt;
&lt;p&gt;Press Esc in the editor to return to your posts. Click your post to open it,
or select it with the arrow keys and press Enter.&lt;/p&gt;
&lt;p&gt;&lt;a target=&quot;_blank&quot; rel=&quot;noopener&quot; href=&quot;/blog/first-session/posts.webp&quot;&gt;&lt;img class=&quot;terminal-screenshot&quot; src=&quot;/blog/first-session/posts.webp&quot; alt=&quot;The post list with A little room to think saved and selected&quot; width=&quot;1000&quot; height=&quot;280&quot; loading=&quot;eager&quot; decoding=&quot;async&quot;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;When you’re done for now, press Ctrl+Q to quit. Next time, run &lt;code&gt;writui&lt;/code&gt;,
enter your password, and you’ll be back where you left off. To lock it
without quitting, press Ctrl+O; unlocking brings you back to the same place.&lt;/p&gt;
&lt;p&gt;To keep a Markdown copy outside writui, open the menu and choose
&lt;strong&gt;Export as markdown&lt;/strong&gt;. Exported files are ordinary text files, so store
them somewhere suitable for what you’ve written.&lt;/p&gt;
</content>
        
    </entry>
    <entry xml:lang="en">
        <title>Hello, world</title>
        <published>2026-10-08T00:00:00+00:00</published>
        <updated>2026-10-08T00:00:00+00:00</updated>
        
        <author>
          <name>Unknown</name>
        </author>
        
        <link rel="alternate" type="text/html" href="https://writui.aak.sh/blog/hello-world/"/>
        <id>https://writui.aak.sh/blog/hello-world/</id>
        
        <content type="html" xml:base="https://writui.aak.sh/blog/hello-world/">&lt;p&gt;This is the first post on the writui blog. Like every post here, it was written in writui itself, in a terminal, in plain markdown, and then exported straight into the site.&lt;/p&gt;
&lt;p&gt;writui is a writing app for the terminal. Your writing lives in one file, encrypted with your password. The editor is a single quiet column of text, and markdown is formatted as you type: &lt;strong&gt;bold&lt;/strong&gt; in bold, &lt;em&gt;italics&lt;/em&gt; in italics, &lt;code&gt;code&lt;/code&gt; in green.&lt;/p&gt;
&lt;p&gt;What it does so far:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Posts with a title, saved as you type, with undo and redo&lt;/li&gt;
&lt;li&gt;Named versions of a post, and a history to bring old ones back&lt;/li&gt;
&lt;li&gt;Selecting, copying and pasting, with the mouse or the keyboard&lt;/li&gt;
&lt;li&gt;A menu of everything you can do, on Ctrl+K&lt;/li&gt;
&lt;li&gt;Copy or export a post as markdown, which is how this one got here&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;It’s early, and it’s being built in the open, a small piece at a time. The &lt;a rel=&quot;external&quot; href=&quot;https://github.com/aakashns/aak.sh/releases?q=writui-v&amp;amp;expanded=true&quot;&gt;changelog&lt;/a&gt; lists every release. To try it on macOS or Linux:&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;curl -fsSL https://writui.aak.sh/install.sh | bash
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;More soon.&lt;/p&gt;
</content>
        
    </entry>
</feed>
