PROSAIC REFERENCE

A writer-first terminal writing app.


CONFIGURATION
-------------

Config location (in order of priority):

  1. PROSAIC_CONFIG_DIR env var
  2. $XDG_CONFIG_HOME/prosaic/
  3. ~/.config/prosaic/

Override with environment variable:

  PROSAIC_CONFIG_DIR=~/custom/path prosaic


GIT INTEGRATION
---------------

If your archive directory contains a git repository:

  - Existing .git directory is detected
  - Repository is inherited (no re-init)
  - Remote URL is read if configured
  - Prompts for remote if none exists


STATUS BAR
----------

  ○ / ●      Autosave (idle / just saved)
  [+] / [·]  Editor (unsaved / saved)
  * / + / ?  Git (modified / staged / untracked)


ARCHIVE STRUCTURE
-----------------

  ~/Prosaic/
    pieces/         Dated markdown with frontmatter
    books/          Long-form projects
    *.md            Drafts (loose files in root)
    notes.md        Quick notes with date headers
    metrics.json    Daily writing statistics
    .git/           Version control


BOOKS
-----

Each book is a directory in books/ with the following structure:

  my-book/
    chapters/         Individual chapter files
      chapter-one.md
      chapter-two.md
    chapters.md       Chapter reading order (one filename per line)
    manuscript.md     Auto-generated compilation (read-only)

Working on a book:
  - Press b on dashboard to open book selection
  - Select or create a book, then select or create a chapter
  - Manuscript auto-compiles on save and when leaving a chapter
  - Press m in chapter selection to compile manually

Upgrading from v1.3.4 or older? Legacy books (single .md files)
are automatically migrated to this structure on first open.
Your original file is preserved with a .bak extension.


PROFILES
--------

Maintain separate workspaces for different projects.

  prosaic --profiles          List all profiles
  prosaic --profile <name>    Use specific profile

Each profile has its own archive, git remote, and theme.
Manage from dashboard (m key) or edit settings.json.


PANE DEFAULTS
-------------

  Mode               Tree    Outline
  ----               ----    -------
  write a piece      shown   hidden
  start writing      shown   shown
  add a note         hidden  shown
  read notes         hidden  shown
  work on a book     hidden  shown
  focus mode         hidden  hidden
  reader mode        hidden  hidden
