Architecture & Shortcuts

Architecture & Shortcuts

Terminal Shortcuts & Commands

Key Bindings

• Ctrl-G: Sends (continue the story).
• Ctrl-W: Sends a transient reset instruction enforcing active story rules.
• Ctrl-U: Removes the last turn from history, sends a reset instruction, and restores the previous user prompt in the terminal buffer for editing.
• Ctrl-L: Read-only view of the last persisted prompt and response.

Application Commands

• /exit or /quit: Exit the program.
• /image <instruction>: Reads an image from the OS clipboard and sends it with the instruction to a vision backend (not saved to history.json).
• /export: Exports the story to Markdown with user prompts in italics.
• /export -intro: Exports story with user prompts in italics between sections.
• /export -clean: Exports assistant story text only.
• /export -all: Chronological export with explicit headers.

---

Code Architecture & Memory Layers

Storyteller operates as a modular monolith separating CLI adapters from reusable core services:

nl.llm.storyteller
├── cli/                 # Terminal UI, JLine adapter, shortcuts, rendering
│   ├── AssistantApp.java
│   ├── TerminalStoryteller.java
│   └── TerminalRenderer.java
└── core/                # Application logic, persistence, prompting, HTTP clients
    ├── AppConfig.java
    ├── service/         # StorySession, PromptAssembly, DerivedMemoryManager
    └── model/           # Prompt inputs & validation outcomes

Prompt Assembly & Memory Structure

Rather than sending full conversation histories, Storyteller builds prompts using:

Single System Message: Combines the main prompt, fixed protagonists, canonical state (canonical-state.yaml), long-term summary (summary.md), and recent summary (recent-summary.md).

Recent Turns: Includes the last chat.maxRecentTurns raw messages.

Latest User Input: Appends the latest prompt.