Docs

Getting started

1. Open Maro Portal on your Mac. The desk is the first screen.
2. Connect the AI providers you want to use: Anthropic Claude, OpenAI Codex, or an on-device model.
3. Talk to Maro in the central conversation and hand off a task.
4. Follow the task through its six steps. A separate reviewer checks it before it closes.
5. Come back to it later in the personal wiki, the knowledge map, and the chronicle.

Finding your way around

The desk is the first screen. The left sidebar lists the desk, the personal wiki, work, the library, and more. Everything you hand off, decide, or learn ends up in one of these places.

A task, step by step

Every task goes through the same six steps. You can see which step a task is on at any time, and nothing counts as done until a separate reviewer has checked it.

• 1

  Born

  A task is opened from the conversation, with your request kept in its original wording.

• 2

  Checked

  Before it runs, the task is checked, so work starts from a clear request rather than a guess.

• 3

  Run

  An AI worker does the work in its own session.

• 4

  Evaluated

  A separate reviewer checks the result. The review receipt names the provider, and a partial pass stays partial.

• 5

  Harvested

  Outputs are filed in dated work folders, and lessons go to the work encyclopedia.

• 6

  Closed

  The task closes with its record. Nothing counts as done until it has been through review.

Personal wiki

Briefings, decisions, and research are kept as pages. The index has tabs for index, recent, important, topics, people, tags, and archive, and the preview panel offers Continue writing and Open original. Each page has a table of contents, its sources, and an at-a-glance box with category, revision number, open questions, and last change.

Knowledge map

Records are grouped into topic islands, such as the morning paper, operating principles, and reports. Seven view tabs show them in different ways: overview, sea, forest, constellation, links, growth, and time.

Library

Source material lives in five rooms: the wiki shelf, the second brain, the knowledge map, the viewer room for books, PDFs, photos, video, and documents, and the knowledge garden. A question box at the bottom lets you ask Maro the librarian.

Work encyclopedia

Rules, concepts, and lessons are sorted by category. Panels show today's document, did you know, new documents, and recently changed, so past mistakes turn into a checklist for later work.

Chronicle

Under Work, the chronicle replays past work as an illustrated story, page by page, with a box for what was learned that day and a flow strip of the work steps.

AI providers

Connect the providers you want to use: Anthropic Claude, OpenAI Codex, or an on-device model. AI calls go only to the providers you connect. Providers are replaceable parts, so a task keeps its history when the model changes.

Getting started

1. Open the bookshelf, enter a title and genre for a new work, then create and open it.
2. Pick a co-writing mode for the work: AI-led, writer-led, or writing together.
3. Write chapter by chapter. Select a passage to ask for changes right there, compare, and apply.
4. Adopt only what you like. Drafts join the manuscript when you adopt them; the original is kept separately.
5. Use the genre tools. The glossary and name finder sit beside the manuscript.

Bookshelf

All your works sit on one shelf, each with its genre and the time it was last opened. The New work form takes a title and a genre; Create and open takes you straight to the manuscript.

The manuscript screen

The manuscript shows counts of characters, words, and paragraphs, and a note that the original is kept separately. Design mode and Writing mode buttons sit at the top. Tabs beside the text hold the manuscript, chat, contents, design, world, dictionary, and review.

Co-writing modes

Choose a mode per work. Whatever the mode, AI drafts join the manuscript only when you adopt them.

• AI-led

  The AI drafts and you choose what to adopt.

• Writer-led

  You write, and the AI helps when you ask.

• Together

  You and the AI write the chapter side by side.

Asking with sources

Ask the co-writing panel about the story through the Claude connection. The answer comes back with the manuscript passages it checked, so you can see what it is based on.

Genre tools and themes

The martial-arts dictionary has tabs for all terms, the work's own dictionary, and general terms, with an Add to conversation button on every entry. A technique-name finder sits above it. Each work can have its own theme, such as a night-sky desk for a fantasy work.