Introducing NEO

Nine years ago, I wrote a blog post about my ideal novel writing tool called NEO. You can read that original post here. The problem I was trying to solve was replicating the clean, crisp workflow I’ve always had in Apple’s Pages, before Apple updated and ruined Pages. Most of my novels have been written in the black, distraction-free full-screen mode Pages creates that you can swipe to and forget about the rest of your laptop. Just your words, a wordcount at the bottom, and an interface that gets out of the way.

Yes, there are thousands of writing tools out there, and the problem with them usually falls into one of two camps: They are made to do everything, so they don’t do anything cleanly, like Word. Or they try to be too clever and give you every book-writing gadget in the universe, like Scrivener. People swear by both. I begrudgingly use them.

Whatever perfect writing tool you’re about to mention in the comments, I’ve probably already tried. I’m so glad it works for you! Keep writing! Stay awesome! None of them work for me. I don’t want to spend any time in my word processor doing ANYTHING but writing. Nothing to break the creative flow state. Just my words. Basic key strokes to do basic things.

Writing a novel in Word or Pages means inserting page breaks, numbering a chapter, centering that number, centering section breaks, uncentering to start writing again, renumbering every chapter because you inserted a new one, ad naseum. NEO was going to be designed from the ground up to do one thing: write long-form prose. That’s it.

The last time I worked on this application, it was with a software developer while I was sailing across the Pacific. Limited internet access made the collaboration difficult, and we never got past basic functionality. It wasn’t good enough for my daily use, so I never shared it with you all. Today, that changes.

NEO can be downloaded here (.dmg for Mac, .exe for Windows)

It’s still rough, not even beta-worthy, but NEO is now the first thing I boot up in the morning. It’s where my writing is happening. And I’m in love with it. But there’s a lot to work on, so it’ll keep changing. If anyone wants to use it, it’s free! If you find bugs or have suggestions, leave a comment on this blog post below (or at GitHub). I’ll take your thoughts into consideration, but I’m not interested in feature creep or bloat. Just simple and functional. If you want to take the source code and run with it, have a great time!

Installing:

Mac users: double-click the .dmg, drag NEO into Applications, then run it. To make your life a little easier, I actually paid for a Mac Developer license and figured out certifications and signing and all that jazz, so you should only get a warning about running software from the internet. None of that “unidentified developer” nonsense. C’mon, you’re on my blog, you know me.
PC users: double-click the installer. You might get a warning and be asked to continue. I’m not going through the Windows developer nonsense because it’s way crazier and you still get warnings anyway. I haven’t tested this version much, so use at your own risk.

A beginners guide for the brave: The first time you open NEO, it’ll ask you for your name and if you are a pantser or a plotter. All that means is whether new documents open in the Outline tab or the Manuscript tab. You can change this option later at any time (go to File > Goals Settings).

The main interface in Neo is your Shelf. You can have lots of WIPs here, and you can create new shelves to keep them organized. Rename shelves by clicking the name.

Create a new WIP in any shelf or import an existing document. Importing will probably require a little fiddling, as this is not the main goal of NEO. It’s more for starting new projects and seeing them to completion.

A few features to highlight:

This is about distraction-free writing with only the things you need at your fingertips. Complex functions are handled with quick key-presses. Need to start a new section in your current chapter? Hit the enter key twice. Need to start a new chapter? Hit the enter key three times. This and your imagination are all you really need to write a novel in Neo. That’s pretty much it.

Chapters are auto-numbered for you, even if you insert one in an earlier place. Hover your mouse on the left side and you’ll see an outline of all your chapters. Feel free to make a brief note here about what happens in that chapter. On the right side you’ll see Placeholders, a feature I’ve always wanted. To create a placeholder, hit COMMAND + SHIFT + X. Make a note about what you need to do here later and keep plowing forward. All your placeholders are hidden away for when you need them. You can lock this window open by clicking the little symbol at the top, for when you are in afternoon-revising-mode.

If you want to get rid of a piece of writing but don’t want to lose it forever, highlight it and drag it down to the DARLINGS tab. Or hit COMMAND + SHIFT +D. It’ll stay there while you improve the draft. If you realize your original stab was better, you can restore darlings from the darlings tab (or you can delete them forever). This allows you to take creative risks without FOMO. You could also use this to make notes in your draft about things that need to happen in the story, and they’ll stay in Darlings pointing back to the correct place. Great for making notes without needing a second document open (my old, clunky way of writing a novel).

There’s an OUTLINE tab at the bottom for people who prefer to structure their documents ahead of time or brainstorm. If you selected PLOTTER during install, you will begin new books in the Outline tab. For PANTSERS it’s always available with a click. Type a note for each chapter and hit ENTER to create a new chapter in the outline. TAB if you want to create sections within chapters. This will create those chapters and sections in your manuscript for you, with the notes there to be replaced with your lovely prose. Outlining might still be a bit clunky, since I’m more of a pantser myself.

I love to write in fullscreen mode. Just hit COMMAND + SHIFT + F to switch to fullscreen. The same combo or ESCAPE will leave it. Even better, when you want to avoid distractions and the easy swipe over to email or social media, ENTER THE SILO. COMMAND + SHIFT + S will seal you in the vault with your WIP. Leaving is more difficult. Staying is easy. So stay and keep writing!

At the bottom of the writing UI you’ll see how many words you’ve written today. Click this to change your personal daily goal and the goal you have in mind for that WIP. You can also do a sprint from here, with a lightning bolt at the bottom letting you know to keep going and a congrats when you hit your goal. I love this feature.

Back on the SHELF, set a word goal for each project, and a yellow bar will move across the bottom as you near completion. It’s a nod to NaNoWriMo, where a lot of my books were written. You’ll see daily bar graphs and other stats over time. This needs a lot more testing. Let me know if you find a major bug.

If you don’t like the color gradient on your book covers, click the little refresh button in the top right corner of the book cover. The colors are just to help your books stand out from each other. Under the FORMAT option at the top bar, you can change the body font and select one of 3 drop-cap fonts. The idea here is that a book should look like a book while you are writing it. You should be as immersed as the reader!

In the FORMAT drop-down, you can also turn TYPEWRITER mode on and off. This just makes it so your cursor stays in the center of the screen, no need to scroll up and down or follow along with your eyes. I like this sometimes but not all the times, so I made it a feature you can turn on and off with a quick COMMAND + SHIFT + T.

You can export your files in several basic formats. But here’s one of my favorite features! For years, I’ve had a habit of emailing my WIPs to myself to back them up. I often do this after a bit of writing flow where great stuff pours out from the ether and I’m terrified I’ll never be able to replicate it. If you hit COMMAND + E, you’ll email yourself a copy of the current WIP in PDF format. Even better, it’ll create a SHA-256 fingerprint for the file, which proves that the file has not been altered or edited. As you write, a series of these will prove beyond a shadow of a doubt that this is a work you’ve been writing over time. That’s not the primary reason for the feature, but might as well while you’re creating a backup and sending it to yourself. The first time you email a WIP it’ll ask you to choose Apple email or Gmail (PC users will be spared the question).

Spellcheck is default off! No red squiggles to evaporate your creative juices. If you want to turn it on, COMMAND + ; (semi-colon). There’s also a find/replace option, because I can’t live without that. And that’s pretty much it. Poke around to discover more. There’s a shortcuts list under the HELP menu.

The main thing is this: I made this for myself, and I don’t expect anyone else to use it, but there might be another author out there who has had the same frustrations as me, or has a similar workflow and is looking for exactly this. If that’s you, I’m glad we found each other. To everyone: stay awesome and keep writing.

Download installation files here from GitHub

Source code here for nerds


45 responses to “Introducing NEO”

  1. I’ve been waiting for this ever since he posted that blog post years ago! Glad to see it’s finally released.

    I released a very similar app years ago, but I was intrigued to see what you come up with.

  2. Will absolutely give this a go. Never been happy with my options out there. Usually end up writing in Editpad as it’s simple and clean.

  3. I’ll give it a shot. For years my go-to has been Ulysses, esp. for the Markdown editor (before that it was Bean.) The “export” function has a fairly steep learning curve, but once you grok it, it’s very powerful (plus there are tons of free templates.) Also does auto cloud sync and versioning.

    1. Ulysses is decent. I used Bean back in 2023. Tiring.

  4. Windows version: After going through the “run anyway” stuff, it says “shortcut missing” because it can’t find “neo.exe”. I did a search of my entire drive and couldn’t find it myself. I did find and installer.exe and and uninstaller (in AppData). Tried running that installer.exe but about halfway through got an error “NEO cannot be closed”. “Retry” gives same error. “Cancel” gives error saying in can’t uninstall the old version (?).

    1. Yeah, same here. It looks like the shortcut itself is broken. It’s unable to find a NEO.exe physical application and is just the shortcut.

      1. One thing I can think of is Windows Defender might be eating the program, which is why the shortcut points at nothing. I’ve got all that safety stuff turned off on my PC. The code is unsigned, so Windows is going to think it’s full of viruses. Look in your threat history and see if you can restore Neo.exe from there. If so, you can add the folder to exclusions.

        1. Thanks for the tip, but it doesn’t appear to be the issue. I added the folder to exclusions and looked at my protection history to see nothing was affected. I got a fresh link and restarted after adding the exclusion and now the installer says it cannot install while NEO is running, yet NEO has not been installed in the first place and has no processes or details running in the task manager. The installer is still not in the folder for the new download either. Thank you for your help, this tool is a really cool idea as it can be very demotivating to write through Word these days.

          1. I added a standalone version of the app, no setup, just NEO 0.2.1.exe. See if that works.

          2. Thank you, but it seems the standalone is having issues as well. I allowed it through all my protections and yet when I try and open it, it does not load up. I ran it as an administrator and it asked if I wanted to allow the application to make changes to my device as it should, but upon saying, “yes” it just never opened. I checked the error reports on my PC and it shows that the application is not having any kind of error in the loading process. I also tried running it through the Command Prompt and it didn’t load or give me a report on why. My PC seems to recognize it as loading for a second since it prompts me to allow it, but does not show up as running in my task manager or in general.

          3. Yeah, I tried this too but to no avail. Still broken. Running on Windows 11 Pro.

    2. Okay, let me see what I can do. I only ran the 0.1.0 version on an old PC laptop I have on the boat. I don’t have a good Windows testing platform. Thanks for reporting this!

      1. I’m getting the same error and haven’t been able to find a workaround yet either. Please let us PC Peasants know if you discover a way past it! I’d love to use this

  5. As always, Hugh, you’re very generous in sharing with writers your journey and process. Thank you!

  6. Patrice Fitzgerald Avatar
    Patrice Fitzgerald

    Amazing! And very cool.

    Thanks.

  7. I’m a software developer, not a writer. I know that this means: “Email a timestamped PDF snapshot to yourself with a SHA-256 fingerprint of the text in the body” but I don’t know why you’d want the SHA-256 fingerprint. I guess for versioning? That’s the only thing I can think of.

    1. Just trying to think of ways to verify that a timestamp of the draft is legit, because eventually you’d be able to have an AI agent create a history of drafts with fake dates and versions to look like a paper trail. You could probably start with an AI-written book now and tell an agent to create a series of older drafts, complete with typos, etc, to make it look handwritten over time. Short of blockchain solutions (which I know nothing about), what else can you think of to show human provenance for a written work? Maybe the emails alone are enough? It’s not really a big deal or important to my own workflow, just thinking about problems to come for writers in general and possible solutions.

      1. I see where you’re going, makes sense. The only thing I can think of is private key/public key cryptography. Which is probably similar to (or the same) as what you’re doing. If only you know (or have) the secret that created the encrypted file, and it’s difficult to crack, then yeah, it should protect you from AI theft.

  8. Okay, why don’t you distribute through the App Store? I am working on a ‘self-publisher dashboard’ app. Along with my other iOS and Droid apps.

    What is your software license?

    I like this!

    1. Just guessing, but probably because it’s an alpha/beta build and he would have to sign up to be a developer, pay Apple $100 per year, be subject to their guidelines and approvals. Or he can just say “here’s the file – install it”. A lot of the best work out there is open source and available for free on GitHub.

  9. Will this work on a Linux system?

    1. I hate to put words in Hugh’s mouth, and he can correct me, but I looked at the code and it looks like a local web app. So with a little leg work you could run it on Linux in Firefox or whatever browser you use.

      1. I created a Linux version and just uploaded that. For x86 chips only for now.

        1. Thank you!

  10. Carter McKnight Avatar

    Sounds like Neo is working for you. My writing platform is OpenOffice Writer, using a pre-formatted template I’ve created, complete with title page, dedication, and other assorted front matter, as well as title, author, and page number at the top of each page, plus drop caps and other niceties. I write IN the template. After “THE END” I import the hyphenless file into Jooma for the Kindle version, and then the print version receives hyphenation and kerning before uploading to KDP. Writing in the template makes formatting minimal. Can Neo match OpenOffice for this kind of convenience?

    1. Sounds like you’ve got a great pipeline! I haven’t fine-tuned it yet, but hoping to export directly to .epub from NEO. If I get it working right, I’ll add .mobi conversion as well, even though most places that need .mobi accept .epub.

  11. I haven’t been able to write fiction in years for just this reason. I’m gonna give it a go and hope I can finally get a few of the stories that have been steeping in my brain over the years out!

    1. Nothing would make me happier! Finish something, get it polished, and send it to me to read.

  12. Thanks for sharing this. I’ve been using Ulysses for the reasons mentioned in earlier posts.

    A couple of things:
    – Is it possible to have a san serif font? Just one or two.
    – And a wierd one. I am in New Zealand, but the date stamp for the installed file uses Pacific Time, not local time. An observation!

  13. Just an observation. Word actually works very well if people use it properly. And use Google when Word does not work properly. I’ve been using Word for decades, which has allowed for learning, or stumbling across by accident, how to ameliorate the current challenge (aka bend it to my will), albeit sometimes only temporarily until the next […….] annoyance. OK, maybe I’m not selling it convincingly, but my relationship with Word (and Microsoft’s infuriating social engineering strategy) has always been adversarial. I’m therefore not inclined to sing its praises much.

    However, based on your list of challenges, there is functionality that covers that stuff…but, as I said, it has to be used properly. Otherwise…. [….] Just sayin’.

  14. Thanks for making this but it’s not going to work for me. I’m so accustomed to being able to jump around my chapters with the sidebar in Scrivner, and then to the notes for each chapter on the opposite sidebar. I think it’s going to be great for pansters but plotters are going to miss quickly navigating their project. I’m keeping it installed and might use it to retype my entire manuscript into when I’m done with the rough draft. (I heard there’s some benefit to typing the whole book from scratch???)

  15. I haven’t even tried this out yet but look forward to it, and wanted to thank you in advance. Just spent 2 years writing a novel in Google Docs, pecking away on my phone. I shipped it off to the beta readers today. Then found this post.

    Two years in GDocs. Sigh. This Neo thing probably would have been a better way to go. Well, if the beta readers like it now I’ll be better equipped to write a sequel!

    Kudos for considering how writers will need to defend themselves re: AI. Feels like the field is already tilting in a … weird direction.

  16. Thank you! Thank you! I’ve already made the switch to Neo. I’ve published two non-fiction books that were begrudgingly typed up in Pages and Word — the horror!

    Loving that the environment is so distraction-free. Love even more the division of spaces into manuscript, notes, outline, and darlings — genius.

    Right now my only suggestion would be to have some control over the size of the UI font. My aging eyes need a slightly larger size. Other than that, I’m using it for my first foray into fiction, a collection of short stories.

    Thanks, Hugh.

  17. Such a great guide. The step-by-step approach makes it easy to follow along.

  18. Thanks for putting this together. The tips here are practical and well-explained.

  19. Love this! Exactly what I needed to read today. Keep up the great work.

  20. Fantastic resource here. I will definitely be coming back to this again.

  21. First I wanna say that finding this felt a bite like fate, like destiny, like magic. I don’t know, but what are the odds of finding a post from four days ago on my Tumblr dashboard at two am four seconds after I told myself: that’s enough go to sleep.

    I’m so glad I didn’t go to sleep because I think it’s the first time doomscrolling actually gave me something of value, something truly precious.

    I installed NEO, and the interface is so beautiful and clean I almost cried. I’ve been playing with it for only some minutes, but I’m in love. Silo Mode is a genius idea, and I was cackling at the witty messages I had to type. I’m not sure, though, whether it was a problem on my ending but the vault didn’t open, no matter how many times I tried, and the only way I could escape it was by turning off my MacBook. That scared me a bit, but not enough to make me not want to use it.

    NEO seriously has the potential to become the BEST writing tool I ever used, and I say this as someone who already used most of them, Notion, Paper, Pages, Scrivener, BYOK Studio, Pinery, StimuWrite, Ellipsus, Obsidian, you name it I probably have used it. I hope you keep on improving on it, and thank you for sharing it for free.

    I’m glad we found each other too. <3

    1. Glad you’re enjoying it!

      1. Hi, after almost a week of using NEO, and close to 10k words and a lot of tinkering, I have a little more in-depth insights.

        **Things I love:**
        – The interface, it’s clean, beautiful, doesn’t overwhelm me, and I could spend the entire day looking at it.
        – Setting both daily and project goals, especially the yellow bar that appears on project covers and let me have a visual reminder of how much I still have to go.
        – Sprint, and showing how many minutes it took to write that amount of words is a nice touch.
        – Darlings, I had one single document titled *my dear dead darlings*, which involved a lot of copy and pasting and moving between files. No more.
        – How easy it is to create text breaks.
        – Rearranging chapters just by dragging it.
        – Notes & Comments, I was never much into the idea of just use a bracket or TK or whatever for information I could research and add later, mostly because I didn’t trust myself to catch all of them. NEO changed that.
        – Deleted chapters going straight to darlings for easy recover.
        – Night mode, because I’m a vampire.
        – Turning off spellcheck entirely, goodbye red squiggly lines under completely normal names that are not recognized, you’re not missed.
        – Outline, I write like it’s night and I’m blindfolded, but I liked being able to write a little summary under each chapter.
        – That I can alternate between total manuscript and chapter word count with just a click.
        (Basically everything. lol)

        Things I find interesting, but forget to use:
        – Send to email, I set it up, but keep forgetting to send the file at the end of the day because I’m still used to automatic saving and sync.
        – Typewriter scrolling, helpful for not getting lost while editing, but usually when I remember about it I already finished.

        **Things I miss:**
        – Option to turn off Drop Cap Style. Personal preference, probably. But I sometimes write City name, time of the day on the beginning of chapters and it keeps messing with the layout.
        – Headers, or even just an option to centralize the text for quotes.
        – Option to create separations in between chapters for books that have Part I, Part II. I can do that with a chapter, but it doesn’t look very pretty.
        – Being able to move a shelf up and down, change its position like I can with the projects.

        Little bugs I noticed:
        – Sometimes it duplicates the first letter of the following word when I erase something in the middle of a sentence, but I’m not sure what causes it.
        – Silo still doesn’t open the hatch when I type the sentence, even after uninstalling and installing again, though it exits full screen mode so I’m locked but can still quit the program without having to turn off my laptop.

        I still love NEO very, very much.

  22. I will definitely give NEO a shot. Sadly, I’m a Plantser. I plot, then pants, then plot, then pants. But this makes Placeholders, Darlings and Outline pretty intriguing to me. Currently, I’m just pasting this stuff in Google docs: placeholders in comments, darlings at the bottom of the manuscript, my evolving outline below that. Plus character studies, theme and symbolism reminders, dialog ideas, etc. So whenever it comes time to “restructure, review or rewrite”, I end up scrolling, opening up multiple tabs, scribbling stuff down on paper. Workarounds that eject me from the flow and send me straight to the coffee machine. So, yeah color me excited.

    As a broader observation, I think NEO is a vanguard entry in a new era of personalized software. As has been your experience, until now, an expert who wanted to put an idea into software form had no choice other than to hire a developer. I’ve seen many such projects die on the vine because: independent programmers are rare people; still too expensive for most pet projects; and unlikely to stick around for the inevitable revision and maintenance that is necessary to make software successful.

    But all this changes with AI. Granted, coding with AI is still a human skill, but it’s one that can be mastered in weeks rather than the years that were necessary to achieve competence with manual coding. And AI is fantastic at maintenance, so the time horizon for personalized software is no longer just the few months until inspiration or financial wherewithal (<— I'd need the spell checker for that word) wear thin.

    Coffee first. Then NEO.

  23. Ah, it’s an Electron app. I’ve coded quite a bit of Electron over the years and so went ahead and cloned the project and gave it a test drive. I really like that the tech aesthetic matches the app philosophy itself. Lean and clean. Overall, the app reminds me of Vellum: highly opinionated and eschewing bloat.

    I did find one serious bug. At one point, while playing with stickies, I hit cmd-z and basically lost the manuscript and all the stickies. I’m honestly not sure how it happened. I tried repeating what I did and couldn’t replicate. So I guess, just know that it’s out there!

    One usability issue is that the manuscript page doesn’t hold its position when you switch to a different view (e.g. outline, notes) and back. Your cursor resets at the very top. Probably an easy fix.

    Bold and italic are hidden features. Claude explained to me how to get to them with key commands. I guess a smarter person would have learned these basic key commands a long time ago. GUIs have made me lazy.

    The way the outline interacts with the manifest is dodgy. I see the makings of a good concept here, the way “sections” appear as guides on the manuscript. But the way three asterisks appear seems oddly broken. It’s also disorienting that the chapter text doesn’t transfer the same way that section text does.

    On the technical side, I like the decision to use `contentEditable`. It arguably offers enough functionality to satisfy most writing requirements. Underline and strikethrough are missing but could be added easily in the existing keystroke listener. Subscript/superscript and small caps might be more challenging, maybe possible with some CSS and clever use of embedded divs. Claude would find a way . . .

    My last book made heavy use of text messages and I’m actively wondering how I would have done this in NEO. In Google docs I used fixed font with single and double indentation while Vellum supports text messages as a native capability. I’ve not used lists in my writing but this could be another gotcha for some writers. Ultimately, it may not matter if things like smallcaps, texts and lists are supported though since it is all get worked out during typesetting anyway. A writer who likes NEO’s environment is likely to put up with some inconvenience.

    I really, really like typewriter mode. It does make cut & paste a 3 click operation rather than a 2 click operation but I think a determined user would quickly adapt to this.

    The sticky interface is promising but needs work. The yellow question mark in its current form is distracting. I think some creative CSS to make it look like a footnote marker would be an improvement. Displaying the sticky contents in a mouseover would be nice but admittedly feature bloat. The current focus mechanism is workable but warrants some sort of highlighting CSS because it’s easy to get lost in a sea of stickies. It is annoying that the sticky list is ordered by entry time rather than by position in the manifest. I like that the stickies persist until you resolve them instead of disappearing when you delete their containing text. But maybe this is what creates the ambiguity that prevents ordering them by manuscript position.

    The intended interplay (if any) between the notes tab and sticky comments is unclear to me. I guess the main thing I want to do with my general notes is to organize them by chapter. Some notes might apply to Chapter 1. Some notes apply to all chapters (for instance symbolism).

    — for emdash is brilliant (I know the keystroke on Mac but can never remember on Windows). Nice touch that … is caught too (though stylistically I always prefer . . . anyway). Of course, this prevents an end user from *actually* typing multiple hyphens, thus begging the Word convention that — reverts back to actual hyphens. (Damned devilish details.)

    Darlings is good. Claude found the keyboard shortcut for me because D&D with my touchpad is always hit or miss, no strike against the software though.

    Personally, I don’t typically go in for goals, stats and gamification (when it comes to writing, I always underperform) but I do think it’s a great feature: “Tonal for writers”. Now you just need to embed inspirational videos to keep writers motivated :)

    Overall, it’s promising. In this state I would probably use it for short stories but would be nervous about committing long form content until I got more comfortable with it. Exporting (and maybe auto-saving) to markdown is probably worth considering as it would allow for easier transfer between other editors. epub would be the bomb.

    1. Great feedback! I’ll see what I can do with the next version.

  24. I was just researching this exact topic and found your insights on NEO fascinating. The focus on a distraction-free writing environment is crucial for many writers today. It’s exciting to see how tools like this can enhance creativity and productivity. For those looking for additional writing resources, I recommend checking out 7best.in. What features do you think are essential in a modern writing tool?

  25. Love the idea of a writing device that deliberately removes distractions instead of adding more features. There’s something appealing about separating the actual writing from everything that comes afterward. Pairing that kind of focused drafting with a clean Markdown workflow for organizing material later could make for a wonderfully simple setup.

Leave a Reply

Your email address will not be published. Required fields are marked *