What drafting builds on
What does this book promise?
What does each character know?
Open-source workflow for long fiction v6.0
COSMO is a long-form fiction workflow built for AI agents.
Characters, foreshadowing, the outline and every revision are recorded, checked, and left for you to approve.
Works with AI agents such as Claude Code, Codex and WorkBuddy · Currently tested on macOS
Chapters 13–15 · In preparation
What does this book promise?
What does each character know?
Drafted from the record,
then read through and cross-checked.
Read the full text.
Nothing is saved until you approve.
Workflow illustration. Writing happens in your AI tool and local files; this site has no online editor.
Why COSMO
What each character knows, where every relationship stands, which setups are still waiting for a payoff: all of it is updated with each approved batch. Before the next chapter, the relevant material is packaged and handed to your AI.
Stories grow as you write them, and the outline should grow with them. Short reviews every three chapters and full reviews every twelve write agreed changes straight back into the outline and chapter cards, so later chapters follow one current plan.
Every change your AI makes goes into a candidate area with a change list first. Nothing reaches the manuscript until you approve it, and if the content changes after approval, you approve again.
Everyday writing
Three chapters per batch by default, one at a time if you prefer, up to five. Your AI drafts the prose, and you set the direction and make the calls; the system handles the materials, the checks and the saving.
Start from the current outline and character state. Decide the chapter's focus, what it reveals and where it ends. The focus can be rising conflict, everyday detail or a shift in a relationship.
Setting, voice sample, recent chapters and relevant history are assembled into a reading package for your AI to draft from. You can add passages, shift the focus or ask for another attempt.
The first pass asks whether a reader would keep going; the second checks continuity and language. Revise together, then reread from the start. Each batch also gets an independent review, and the whole arc is reread when it ends.
The chapters go into a candidate together with character state and fact records. The system runs a dry run and lists every change; once you approve, everything is written in one step and the state is updated for the next chapter.
Stage reviews
The smoother the writing feels, the easier it is to drift. COSMO counts finalized chapters and flags reviews when they are due: short reviews look at how the last few chapters read, full reviews test whether the structure of the whole stage still holds.
Every review starts with the manuscript, then a conversation with you. Agreed changes go back into the existing outline and chapter cards, and later chapters follow them directly. Keeping the original plan is fine too; the reason is written down.
See how reviews shape later chaptersAre expectations moving? Have feelings or relationships shifted? Why would a reader keep going?
Has this stage delivered on its promise? What stays, and what changes?
A full review includes the short review due at that point. The program flags and records reviews; you and your AI do the reading and judging. Reviews are not scores for your novel.
Local first
COSMO is a set of Markdown workflow documents and Python tools that use only the Python standard library. The documents tell your AI what to do at each step; the tools assemble, check and save. Your novel stays on your machine as ordinary files.
Explore how it worksChanges agreed in a review are written back into the original outline, so there are never two competing plans.
Rework, misunderstandings and blockers are recorded with their evidence, along with how they were handled and verified.
Updates touch only tools and shared rules. If an update finds local changes it does not recognize, it stops.
Get started
Unzip the download and drag the whole folder into an AI agent workspace such as Claude Code, ChatGPT Codex or WorkBuddy, then send the opening prompt. Your AI guides you through setting up the book from there.
Currently tested on macOS only. Windows, Linux and WSL need your own adaptation and testing; compatibility is not guaranteed in this release.
Your AI tool must be able to read and write files and run commands; chat attachments are not enough. If the project does not open after you drag it in, set the folder as the working directory. See the FAQ for other tools.
Please read AGENTS.md and START_HERE.md in this folder, then follow their workflow to guide me through starting a novel.
Paste and send. Your AI checks the Python environment and sets up the project by following the entry instructions.
Next
Hand over any outline, character notes or draft pages you already have. If all you have is an idea, start there and talk about the story and how you want to work together.
Your book lives in this folder. Open it again next time and pick up where you left off.
Keep an unused copy of the folder before you begin, and duplicate it for each new book. You can also download a fresh copy from GitHub at any time.
FAQ
No. This site is an introduction. Drafting, research and revision happen in your AI tool, and the workflow runs through local Python tools. The core scripts work offline; whether your AI service goes online and how it handles your material depends on the tool you choose.
COSMO is free and open source. It has no built-in paid API and never calls a model for you. Your AI tool bills according to its own pricing.
Token usage is hard to predict: the same text tokenizes differently across models, and the amount of context and the number of exchanges both matter. The character budgets in COSMO only limit how much material goes into a reading package; they are not token or cost caps. Try a chapter or two and check your actual usage.
Any agent that can open the whole project folder, read and write files and run commands. Here are some options; pick one you are comfortable with.
Desktop workspaces: WorkBuddy; Claude Code also offers desktop, editor and terminal interfaces.
Agents in an editor: Cursor Agent, GitHub Copilot (VS Code agents) and Cline.
Command-line tools: Codex CLI, Claude Code and Gemini CLI. Cline also has a CLI.
Uploading files to a chat is not enough. For cloud workspaces, confirm that the complete project can be exported or synced back to your machine. If you use another file-enabled Claude mode, check separately that it can read the whole project, run commands and save changes.
All links are official sources, checked on September 23, 2026. The list is not a compatibility certification or a ranking of writing quality. This release is tested on macOS only and requires Python 3.9+; a tool that runs on Windows does not mean COSMO supports native Windows. Try it on a separate copy first.
Not yet. The English website translates the introduction; the system core, templates and user documentation are still primarily in Chinese, and a complete English writing experience is not promised.
The licenses allow you to adapt COSMO to other languages. That means adapting prompts and templates, Chinese paths and field parsing, and the language checks, then validating everything with an example project.
Yes. New books use General mode by default, which checks reader expectations and how each stage develops. It suits relationship, coming-of-age and slice-of-life stories, and it allows a natural ending. Progression and Conflict mode adds checks for opponents, escalation and satisfying payoffs.
Books upgraded from earlier versions are unaffected: older cards keep their original meaning, and books that never enabled this feature do not need to fill anything in.
No. Reviews look at what keeps a reader engaged, and a quiet chapter can move the story through a new feeling, a changed relationship or fresh information. The review pinpoints where a passage loses interest before anything speeds up, and it never piles on conflict or twists mechanically.
The program only flags that a review is due; you and your AI reach the conclusions by reading. Good prose does not need to change just to fill in a form.
No. Research into ranked books is optional; if you skip it, note the reason. If you do it, an AI tool with browsing access picks comparable works, reads legally accessible consecutive passages, records sources, dates and reading scope, and distills general techniques this book could use.
If access is limited, it records what was actually read and does not automatically add a follow-up task to the next cycle. COSMO's own tools never go online and never treat a synopsis as a chapter that was read.
No. The chosen sample enters a candidate first: INIT during book setup, REVISE for a book already in progress. The adopted voice sample changes only after the sample analysis is complete and you approve it.
An existing book that needs its setup redone can explicitly choose INIT. If both kinds of candidate exist, the tool asks you to pick which one this round handles. Voice, genre plugins and story mode are separate choices.
After a chapter commit succeeds, 6.0 moves the candidate into a retained-candidate directory and reports where it is. Anything saved during the commit can be checked there. It never becomes part of the manuscript automatically, and your earlier approval does not cover it.
Regular backups keep the current adopted content, excluding candidates, retained candidates, reading packages and transaction history. Save important unused material separately. A snapshot taken during an interrupted save preserves the scene but does not guarantee a consistent book can be restored from it; check the records before recovering.
Yes. Your agreements and progress are stored in local files, so another AI tool that works with local files can pick up where you left off. There are 4 optional genre plugins: mystery, romance, science fiction and fantasy, and serialized web fiction. You can also use none.
After switching tools, have the new AI read the book's entry files and current state first. Later decisions still follow what you have approved.
No. Start a new book from a saved blank copy or a fresh download, and keep using the existing folder for the book you are writing. Before updating, the system checks the recorded installation baseline; unknown differences or local edits stop the update by default, and recognized book-specific customizations are preserved by rule.
An update never adopts a new story plan for you or changes what you have written.
The 6.0 release self-test passes 446 / 446 checks, covering book setup, reading packages, commits, revisions, review records, synchronization and recovery.
Passing software checks does not prove a novel is good. Characters, prose and reader engagement still need real reading and reader feedback. See the acceptance report (Chinese) and known limitations (Chinese).
I'm LISIYUAN. I'm neither a professional novelist nor a professional software developer. I built COSMO through Vibe Coding to support my own Chinese-language novel writing, using ChatGPT 6 Astra and Claude Opus 5 as my main tools for development and revision. I also hope it helps people without screenwriting or fiction-writing experience develop stories of their own. The project is still being refined.
Back up your work and try a small experiment on a copy first. Check that the workflow suits you before using it on your main project. Test coverage is limited and cannot guarantee reliability in every use case or the quality of the writing. You still need to review the prose and creative decisions yourself.