Ask in sentences — the Luna AI assistant
Luna is an agentic assistant that understands your request and searches, reads, and compares documents on its own before answering. One sentence — “find the quarterly report and summarize it” — covers search, reading, and summarizing.
Prerequisite
Luna activates when an LLM is connected
Click the Luna tab in the main window to open the chat. The badge at the top shows the connected provider and model — click it to switch models. If no LLM is connected yet, set one up in Settings → LLM.
Basics
Ask, stop, and retry
- Send: Enter — new line with Shift+Enter.
- Stop: cut a long response short with the stop button.
- Retry / copy: buttons under each answer re-ask the question or copy the whole response.
- Edit your message: use the pencil button to revise an earlier prompt. All later messages are removed and a new answer is generated, but completed tool actions are not rolled back — including files already created or changed and data already sent externally.
- Tables and code: responses render as Markdown — tables, lists, and code blocks display cleanly.
Rich output
Mermaid diagrams and sandboxed HTML preview
When Luna visualizes a structure or proposes a small interface, you can inspect the result instead of reading code alone. Completed mermaid blocks render as diagrams, and html blocks gain a separate preview action.
- Mermaid: renders after the response finishes. Toggle between diagram and code; syntax failures leave the source available with an error state.
- HTML: the preview opens in a sandboxed frame with scripts disabled. Use it to inspect layout, and review the source for anything important.
Agentic behavior
Understanding Luna's tool runs
Before answering, Luna runs whatever tools it needs and shows each run inline — the tool name plus a result summary (e.g. “found 3 related documents”), so you can see what the answer is based on.
| Tool | What it does |
|---|---|
| Search files | Finds documents in watched folders by name and content. |
| Read document | Reads pages or sections of a document as evidence for the answer. |
| Compare documents | Compares the extracted text of two documents; results appear as a collapsible diff card. |
| Folder tree | Reads the folder/file structure inside watched folders. |
| External MCP tools | External tools enabled in Connection Center (web search, …); may ask for your approval first. |
Tool rows record what Luna read. AI answers can still be wrong, so for important decisions verify the source document, page, and original text.
Attachments
Focus the question on specific files
If your question is about specific documents, attach them — Luna analyzes attached files first.
- + button: opens a file picker (multi-select, up to 10 files).
- Drag & drop: drop files from Explorer straight into the chat.
- Paste from clipboard: press Ctrl+V in the composer to attach files copied from Explorer or clipboard images. Files transferred as clipboard data are limited to 25MB each.
- Supported formats: same as search — PDF, HWP/HWPX, Word, Excel, PowerPoint, TXT, MD.
- Files outside watched folders: can be analyzed in that conversation, but are not added to the index.
Large attachments: files at or above 100MB show a warning. Documents with many pages can also take much longer to analyze. Attach only what the question needs and identify the relevant range or pages when possible.
History
Managing chat sessions
- New chat: the + button in the left rail. Starting fresh per topic keeps answers sharp.
- Open history: expand the sidebar with the panel button; titles are generated from the first question.
- Delete: trash icon per session; delete everything via “Clear chat history” in Settings → Engine.
- Storage: up to 100 sessions, stored only on your PC.
In practice
Prompts that work well
| Example request | What Luna does |
|---|---|
| “Find the 2026 business plan and summarize the key points” | Search → read → bullet/table summary |
| “Find the termination clause in this contract” (attached) | Locates and quotes the clause with its page |
| “Compare last year's plan with this year's” | Reads both and produces a diff card with a change list |
| “Show me the structure of this project folder” | Reads the folder tree (inside watched folders only) |
| “Extract only the decisions from the minutes as a table” | Finds and reads the minutes, then tabulates the decisions |
MCP
Approving external (MCP) tools
Enable external MCP servers in the Connection Center and Luna can also use tools like web search. When a tool requires confirmation, an approval card appears in the chat — choose allow once, always allow, or deny. Deny anything you did not expect.