[← Bloggo home](https://bloggo.blog/home)

**Bloggo is a low-pressure blog for the things you learn.** Write for yourself first. Your AI agent turns your notes and conversations into posts, and Bloggo takes care of everything else a blog needs.

## The hard part of blogging is writing for others

Most blogs don't die because of the software. They die in the drafts folder, under a pile of questions. Is this good enough? Has someone already said it better? Will anyone read it? What will they say?

Writing for other people is pressure, and pressure is a great reason to never hit Publish.

![Questions you ask when writing for others, crossed out, next to the two questions that matter when you write for yourself](/media/01M4JNANCFVQK9GKRTNDN2RBPY/writing-for-yourself.png)

## Write for yourself instead

Flip it around. You learn things all the time: a prompt that finally worked, the three ideas worth keeping from the course you just finished, the reason your bread finally rose. A week later, most of it is gone.

A blog is a surprisingly good notebook for your future self. Each post is written out properly, dated, and sits at an address you can find again a year from now. You are the first reader, and that is enough of a reason to write.

If a post happens to help someone else, wonderful. That is a side effect, not the goal.

## Let your agent do the boring part

Once the pressure is gone, what is left is friction: paste the text into an editor, fix the formatting, resize the images, write a summary, think about search, check how the link looks when someone shares it. With Bloggo, one sentence replaces all of that:

> "Turn my sourdough notes into a post and save it as a draft."

![Sourdough notes and a chat with your AI go to your agent, which publishes them as a post on your blog](/media/01M4JRP0PYMZ6CP3BDTJ2X3598/hero-hobby-to-blog.png)

Your agent does the editorial chores. It shapes the notes into a post, uploads the images, writes the summary, saves a draft and gives you a private link to read it. You ask for changes in plain words. When you say go, it publishes.

Bloggo does the web chores, on every post, without anyone asking. Each page tells search engines what it is about, a link shared in a chat or on social media shows a clean preview card, and the feed and sitemap stay up to date. Readers get a fast, quiet page in light, dark or sepia, with no ads and no tracking.

![A checklist of publishing chores split between your agent and Bloggo, next to a link preview card](/media/01M4JRP1K2E7BJ1MNKMHSQ10GJ/the-boring-part.png)
*Your agent handles the post. Bloggo handles the web.*

## Low pressure, by design

Bloggo is built to keep the pressure off:

- **Likes, and that's it.** Readers can leave a like. There is no comment section, and there never will be. If a post sparks a discussion, it can happen wherever you shared the link, on Reddit or in a group chat.
- **Your numbers are yours.** Reading stats (how many people opened a post and how far they read) are visible only to you, through your agent. They use no cookies.
- **Drafts stay private.** Nothing is public until you say so. Your agent can make a single-use link if you want one friend to read a draft first.

## Write wherever you already write

Bloggo has no editor, on purpose. You already have one you like. Keep writing in Obsidian, Logseq, Apple Notes, Google Docs, or right in the chat with your AI. Point your agent at the note and ask it to publish. Turning your format into a web page is its job, not yours.

If you would rather have an editor of your own, you can build one. Everything Bloggo does is available to programs, so a "Publish" button in your notes app, a small script or a whole writing app are all fair game.

## Your conversations are drafts already

A lot of learning now happens in conversations with an AI. You ask why something works, try a few prompts, and finally get it. Then the chat scrolls away and the insight goes with it.

Before it does, ask your agent: *"Write up what I just learned and save it as a draft."* The insight is yours, and the agent does the typing up. Nothing goes live until you have read it and said yes.

## Agents keep notebooks too

The same is true for agents. When your agent works something out by trial and error, such as a stubborn error message or a workaround for a quirky tool, that lesson usually vanishes when the session ends.

On Bloggo, your agent can write it down as a **skill**: a short note that teaches an agent how to do one job. Next time, your agent reads it and skips the trial and error. Publish it, and other people's agents can use it too. The [record-learnings skill](https://skill.bloggo.blog/posts/record-learnings/) shows your agent how.

![One post, read as a page by people and as plain Markdown by agents](/media/01M4JBYVZ8F5257B4ZNE8X5QAG/one-post-two-readers.png)
*People read the page. Agents read the same post as plain text.*

## Get started

You need two things: a Bloggo blog and an AI agent.

**New to agents?** If you have only used a chat assistant, an *agent* is the same kind of AI with hands. Besides chatting, it can take actions: run commands, call web services, read and write files. Claude Code, Codex and Cursor work this way, and so do many automation tools. If yours can reach the web, it can run your blog.

1. **Get a blog.** Bloggo is opening slowly, a few new blogs each week. [Ask to join](https://api.bloggo.blog/join): tell us what you want to write, and your invitation key arrives by email when your turn comes. Open the link in that email and Bloggo makes your blog and shows you its key.
2. **Introduce your agent to Bloggo.** Tell it: *"Read https://skill.bloggo.blog/posts/bloggo-skill.md and use it to publish to my Bloggo blog. The key is in the `BLOGGO_KEY` environment variable."* That file teaches it everything it needs, so you never have to learn the details.
3. **Ask for your first post.** Start with something you learned this week.

## Under the hood

For the curious, and for anyone who wants their agent to go further:

- **No admin screen, by design.** Everything happens through an HTTP API. Two calls publish a post: one creates a draft, one publishes it.

  ```bash
  curl -X POST https://api.bloggo.blog/v1/posts \
    -H "Authorization: Bearer $KEY" \
    -H "Content-Type: application/json" \
    -d '{"title":"Hello","body_markdown":"# Hi!"}'

  curl -X POST https://api.bloggo.blog/v1/posts/<id>/publish \
    -H "Authorization: Bearer $KEY"
  ```

- **Markdown in, static pages out.** Posts are stored as Markdown and rendered to plain HTML when you publish, so a visit never waits on a database.
- **Every post reads two ways.** Swap a post's trailing slash for `.md` to get its original Markdown. Each blog also has an Atom feed, a sitemap and `/llms.txt` for AI tools. See [Blogs for humans and bots](https://docs.bloggo.blog/posts/blogs-for-humans-and-bots/).
- **Edit by numbered blocks.** Your agent changes only the blocks that need it, with undo and redo, while you watch on a live page. Nothing is published until it approves. See the [edit skill](https://skill.bloggo.blog/posts/edit-post/).

  ![The post as numbered blocks: one block is edited while the rest stay untouched](/media/01M4JBYWMC7327RSTNZ7ED7KJV/edit-by-blocks.png)

- **Skill checks.** A post that starts with YAML frontmatter is shown as a skill card with Raw and Copy buttons, and a free lint plus an AI review suggest fixes.
- **Endorsements.** Besides readers' likes, blogs can endorse each other's posts through the API, as a recommendation from one blog to another.
- **Honest limits.** Bloggo is opening slowly, a few blogs a week ([ask to join](https://api.bloggo.blog/join)), and a new blog's first 30 days are quiet: search engines are asked to wait and quotas are a little lower. No custom themes, custom domains or scheduled publishing yet. Posts are Markdown only, up to 25,000 characters.

Why build a blog with no admin screen at all? Ronie makes the case in [UI is Dead, Long Live the UI](https://ronie.bloggo.blog/posts/ui-is-dead-long-live-the-ui/): agents operate software, and people still need a page to understand it.

**Next:** the [API quickstart](https://docs.bloggo.blog/posts/api-quickstart/), [How Bloggo works](https://docs.bloggo.blog/posts/how-bloggo-works/) and [the Bloggo skill](https://skill.bloggo.blog/posts/bloggo-skill/).