Work with an assistant

Ask for the result you need. The assistant can read your files, make edits, compile the paper, and inspect the output in the same workspace.

Compile this paper, read the errors, and fix the build. Compile again to check the result.

Open the assistant panel and choose a connected model or CLI agent. Set up AI covers both routes.

The LaTeX editor beside the assistant, its skills, and composer controls Open full screenshot

Give it the right context

Mention a file or folder with @, attach a reference document, or select a passage before asking. File mentions carry the file content; folder mentions carry a listing so the assistant can find the material it needs.

The built-in assistant starts with project context such as the active file, selection, structure, and compile state. It can read more through tools. Linked folders let you reference data and PDFs outside the manuscript folder.

Follow the work

Replies show text, tool activity, proposed changes, and progress in order. Expand a tool card to read its output. A compile result can lead you to the log or PDF; a literature result can lead you to a paper.

Ask it to…	What it can work with
Improve a section	Project files, selected text, your instructions, and editable diffs
Fix a build	The compiler, diagnostics, logs, and PDF text
Add supporting literature	Search results, metadata lookup, and your bibliography
Draw a diagram	TikZ or PGFPlots source, isolated previews, and figure insertion
Review the paper	The draft, references, research notes, and review skills

Tools depend on the document engine and selected runtime. Use the tools control to choose which groups are available.

Plan before editing

Turn on Plan for a job that needs a few decisions first. The assistant can read and search while preparing a checklist. It waits before editing, compiling, or running commands.

When the plan appears, choose Approve plan or Revise. You can also type feedback. The progress pill shows the current step and changed files while the work runs. Approving a plan keeps your selected edit-approval policy.

Review proposed edits

Choose Ask for approval when you want to inspect changes before they are applied. Read the diff and approve or reject the action. Approve for me and Full access give the assistant more autonomy; the active policy appears in the interface.

For work you want to review only after the agent finishes, use a research task. Tasks work on an isolated copy and let you apply selected files.

Change direction mid-run

Send a follow-up while the assistant is working, then choose Steer now to deliver it at the next safe point. For example:

Keep the existing notation. Focus the revision on the explanation below Equation 3.

If the run finishes first, the message becomes the next turn. Stop cancels an active run.

Reuse a good workflow

Type / to choose a skill, or use Record a skill after a useful conversation. A skill can capture a procedure you repeat across papers: check claims, prepare figures, or draft a response letter.

Personas and standing instructions live in AI settings. Use them for preferences such as spelling, tone, and notation.

History and usage

Open chat history to return to an earlier conversation. Replies with a saved restore point offer a restoration action. For document history beyond a chat, use Versioning.

The usage counter opens the usage report, where you can filter work by project, model, runtime, and date.

Hosted models receive the context supplied to them. Use a local model when you want model requests to stay on your machine. You can also float the assistant over the editor and dock it again.

New chat

The assistant toolbar contains MCP settings, tool management, settings, usage, New chat (+), history, and floating view. Open full screenshot

Click New chat in the assistant header to start a separate conversation. Use a new chat for a distinct question or chapter so its context is easier to follow. New chats begin with your configured default model.

Chat history

Click Chat history to reopen a conversation. Continue from its existing messages when you want to revise a previous result or ask how it was produced.

Attach files

The + below the message field opens Add context. Approval mode, prompts, persona, Plan mode, model, and Send share this row. Open full screenshot

Open the attachment menu to add supporting material. The file picker accepts images, PDFs, text, LaTeX, Typst, BibTeX, and Markdown files. Review the attachment chips above the composer before sending.

Remove an attachment

Use the remove control on an attachment chip to exclude it from the next message. This removes the attachment from the draft message, not the original file on disk.

Mention a file or folder

Type @ and choose a matching project item. A file mention supplies file content; a folder mention supplies a listing the assistant can use to decide what to read next. Name the relevant section in your prompt as well when the file is long.

Prompts

Open Prompts for ready-made starting requests. Selecting one fills the composer so you can tailor it to the current paper before sending. Include a concrete target, such as a section name or failed compile.

Persona

Choose a persona from the composer for a saved instruction preset. Select None to return to your default instructions. An active persona replaces the default custom-instruction text; Instructions and approvals explains how to configure both.

Model selector

Choose a configured provider and enabled model. Pick a model with the capabilities the task needs: a vision task requires image support, while multi-step project work requires working tool support. Use Check again if a capability check needs to be retried after changing the endpoint or model.

Reasoning effort

When the selected model or runtime offers a reasoning control, choose its effort level for the task. Available values depend on that model. Higher effort can increase response time and usage; a short wording change usually needs less than a detailed manuscript review.

Send

Click Send to submit the message with its selected attachments, model, persona, and approval mode. Read the task back before sending if it involves several files.

Stop

Click Stop to cancel the active run. Inspect any changes already made before asking the assistant to continue; stopping a run does not undo completed edits.

Scroll to bottom

Use Scroll to bottom to return to the latest message after reading earlier tool output. You can scroll up to inspect the conversation while work continues.

Queued messages

Send a follow-up during an active run to queue it. Steer now passes the instruction at the next safe point. Use Discard queued message to remove a follow-up you no longer want delivered.

Persistent goal

Set a goal when several turns should work toward the same outcome. Enter the objective and choose Save goal. Click the goal chip to edit it, or Clear goal to remove it. Keep the goal concrete, such as preparing the methods section and its figures for review.

Assistant settings

The header’s settings control opens AI configuration. Use it to connect providers, enable models, edit instructions, or manage personas and skills.

Assistant MCP settings

The MCP settings control opens the external-server configuration for tools used by the built-in assistant. This is separate from the server that lets an external application control Oleafly. See MCP connections.

Usage report

Click the usage indicator or Usage report to inspect the recorded work. Use the report’s filters to compare projects, models, runtimes, or date ranges. Usage and budgets explains the fields and budget controls.

Review one section from start to finish

1. Select the section and mention its source file in the composer.
2. Choose a connected model and Ask for approval.
3. Ask: “Review this section for clarity. Preserve the claims, numbers, labels, and citation keys. Propose the changes first.”
4. Read the proposed edit and its explanation.
5. Approve the changes you want, then ask the assistant to compile.
6. Inspect the updated section in the PDF, including references and figure placement.