Core Concepts

Understand how Nebula Writer is organized and how the AI fits into a local-first workflow.

When to Use This Page

  • You are new to Nebula Writer and want the mental model
  • You want to understand how folders and files are stored
  • You want to know how AI context and diffs work

Folders = Your Project Workspace

Nebula Writer works directly with your filesystem. You choose a folder on your computer and Nebula Writer reads and edits the files inside it.

  • Open any folder as a project workspace
  • Switch folders from the app menu
  • Your file structure remains intact on disk

Local-First by Default

Nebula Writer stores documents locally so you stay in control.

  • Work offline for writing and editing
  • AI features require an internet connection
  • Export and share in standard file formats

Files and Formats

Nebula Writer works with standard formats:

FormatUse Case
MarkdownNotes, drafts, quick writing
LaTeXAcademic papers, technical docs
DOCXWord-compatible documents
PDFView and extract text for reference

AI Context

The AI has access to the active document plus any files you @mention in a prompt.

How Context is Chosen

  • The open document is included automatically
  • Use @filename to include other files
  • Remove the active context if you want a fresh read

Examples

Summarize the conclusion of the active document.
Compare @chapter-1.md with @chapter-2.md.
Check @references.bib for missing citations.

Reviewable Diffs

Every AI edit is shown as a diff before it is applied. You stay in control:

  • Accept all changes
  • Reject all changes
  • Review change by change

Privacy Principles

  • Documents stay local on your machine
  • AI requests only send the context you choose
  • You can work without signing in if you do not use AI

Supported Platforms

Nebula Writer is available for macOS and Windows.

Next Steps