Skip to content

AI assistant ​

Aurora has AI tools for writing in the editor, an assistant that can answer questions and work in your workspace, research briefs, and image generation. You can use your own provider key (BYOK) or, where your account includes it, AuroraAI, Aurora's hosted AI. What you see depends on your workspace type, encryption, configured providers and account.

In the app, the assistant panel and its row in Settings → AI are labelled AuroraAI, whichever provider answers.

AI Surfaces ​

SurfaceWhereUse it for
AI writingselection menu in the editorrewrite, shorten, expand, fix grammar, translate, or edit with your own instruction
Draft text/ai in the editorwrite new text from a description
Assistantpanel, ⌘⇧A (Ctrl+Shift+A on Windows and Linux)multi-turn chat about a page or the whole workspace, with actions
Research brief/research, or Research brief mode in the assistantone question in, a cited draft out
Image generationcover, background, inline image and avatar dialogsgenerate images with your own image provider

Writing In The Editor ​

Select text and choose an action from the AI writing menu:

  • Rewrite — clearer wording, same language and meaning
  • Shorten — more concise, same meaning
  • Expand — more detail
  • Fix grammar — spelling, grammar and punctuation only
  • Translate — to English, or to Norwegian if the text is already English
  • Custom instruction… — tell AI what to do, for example "Turn it into a bulleted list"

Aurora shows the proposed text next to the original, with additions highlighted and removals struck through. Nothing changes until you click Replace selection. Only the selected text and your instruction are sent.

A rewrite only works on text. If the selection contains an image, table, divider, page link or other embedded item, Aurora says so and sends nothing. The preview also tells you if the replacement would drop formatting; Undo brings it back.

To write something new, type /ai, choose AI: draft text, describe what you want, and click Insert to put the result at the cursor. Only your description is sent.

The Assistant ​

Open the assistant with ⌘⇧A.

  • What AuroraAI can see switches between This page and Workspace. Page scope includes the open page and its properties; workspace scope searches across the workspace and answers with links to the pages it used.
  • Add pages attaches more pages to the question. The page you have open is always included.
  • Paste a screenshot into the message box to ask about it. This needs your own provider with a model that can read images.
  • Queue messages while the assistant is still answering.
  • Insert into page adds an answer and its sources to the end of the open page.
  • Continue picks up an answer that was cut off by a reload or a closed tab, without sending anything twice.

Conversations are kept on your device for each account and workspace, and are removed when you sign out. In an end-to-end encrypted workspace they are encrypted and stay unreadable while the workspace is locked.

What the assistant can do ​

With tools, the assistant can search and read pages in the workspace, create and rename pages, replace a page's text, create and update tasks, set properties, work with templates and page types, move pages to the trash and restore them, and create presentations. It can also read web pages you link to. Web search works only when it is available on AuroraCloud; otherwise the assistant says so and offers to read links you paste.

The assistant stops a question after 12 steps. On AuroraAI, each step counts against your allowance.

Approving changes ​

The workspace's AuroraAI action policy decides how changes are handled:

  • Read-only — the assistant can't create or change anything.
  • Require confirmation — every change waits for you to click Apply changes.
  • Allow direct actions — changes run straight away when your own settings also allow it.

Some actions always wait for your approval, whatever the policy:

  • moving pages to the trash
  • any change, and any further web read or search, after the assistant has read a web page or you pasted a screenshot in that turn, so you see the exact address or query before anything leaves the workspace

Research Briefs ​

Type /research in a page, or switch the assistant from Ask to Research brief. Ask one question, choose where to look (My notes, Links I give, or Web search when it is available), and pick a shape: Brief, Memo, Outline or Talk. Aurora writes a draft with numbered citations and a Sources list into the page or a new page. Each run reads at most a few links and makes a small number of AI calls. Cancel stops the run and adds nothing.

Your Own Providers (BYOK) ​

Open Settings → Account → AI to add provider keys and choose which provider powers each feature: Writing assistant, AuroraAI (the assistant), Image generation, Workspace avatars, Speech to text and Text to speech.

ProviderWriting and assistantImagesSpeechNotes
Anthropic✓
OpenAI✓✓✓
Mistral✓✓EU hosted
Google Gemini✓
Scaleway✓
OpenRouter✓
Requesty✓EU hosted
airouter.ch✓✓Swiss hosted
Ollama (Local)✓runs on your machine, no key needed
LM Studio (Local)✓runs on your machine, no key needed
fal.ai✓
Leonardo.ai✓
Together AI✓
Black Forest Labs (EU)✓EU hosted
Ideogram✓

You can also add a custom endpoint: any OpenAI-compatible or Anthropic-compatible API, or a local Ollama or LM Studio server. Give it a name, base URL, key and default model, and use Test to check the connection. Requests go straight from your device to the address you enter. A remote endpoint must use https://, can't contain a username or password in the address, and can't point to a private network address; use the local options for a model on your own machine.

Aurora loads each provider's model list when you add a key, and shows which models can read images and use tools. If a saved model is no longer offered, Aurora warns you and suggests the provider's default.

On desktop, provider keys are remembered in the operating system's keychain. Turn off Remember AI keys on this desktop if you want them kept for the current session only. In the browser, keys are stored in that browser.

AuroraAI ​

AuroraAI is Aurora's hosted AI. It runs through AuroraCloud instead of your own key, and Aurora chooses the underlying model. It is available only when:

  • you are signed in to AuroraCloud and the workspace is an AuroraCloud workspace
  • your account includes AuroraAI and has allowance left
  • the workspace's AI policy allows it
  • for an encrypted workspace, the policy allows hosted AI and you have given consent

AuroraAI is not included on new accounts by default. Where Aurora has turned it on for your account, you get a monthly AuroraAI allowance set by Aurora; Settings → Account → AI and Settings → Account → Usage & cost show what you have left. There is also a daily cap, so one busy day can't use up the whole month. The AuroraAI card in Settings → AI explains why AuroraAI is or isn't available. See Usage & billing.

Screenshots, image generation and speech need your own provider. AuroraAI is meant for work in your Aurora workspace and may decline unrelated requests, such as general coding help.

In an end-to-end encrypted workspace, AI sends decrypted content only after you allow it. This applies to AuroraAI and to your own provider. The first time, Aurora asks; your answer is remembered on this device for that workspace and provider address. Another provider or address, or turning encryption off and on, asks again. If you decline, nothing is sent. Note that in the assistant, AI can use tools to read any page in the workspace, not only the page you have open.

To take consent back, use Revoke under AI consent for this encrypted workspace in Settings → AI.

Workspaces without an AuroraCloud account work the same way: each of your own providers asks once before it receives anything, and you can revoke it under Provider consent in Settings → AI.

Workspace AI Policy ​

Workspace owners set the AI policy in Settings → Workspace → Features:

  • Allow hosted AuroraAI
  • Allow BYOK providers
  • Allow custom BYOK providers
  • Allow hosted AuroraAI in E2EE workspaces
  • Require explicit consent for E2EE hosted requests
  • AuroraAI action policy: Read-only, Require confirmation, or Allow direct actions

Semantic Workspace Retrieval ​

When Use semantic workspace retrieval is on, the assistant can also use close matches from AuroraCloud's search index of the workspace. A status badge shows whether retrieval is ready, updating, turned off or limited. Turning it off for a cloud workspace clears the stored index.

Answers can cite the pages they used, but review them. AI can miss context.

Workspace Types ​

WorkspaceYour own providerAuroraAISemantic retrievalMCP
Browser storage or folder without AuroraCloudafter you allow each providernot availablenot availablenot available
AuroraCloudavailablewhen your account and workspace policy allow itwhen turned onwith granted access
AuroraCloud, encrypted and lockednot for locked contentnot availablenot availablecan't read content
AuroraCloud, encrypted and unlockedafter you give consentwhen policy allows it and you give consentlimitedcan't read content

Image generation needs an AuroraCloud workspace and your own image provider.

Image Generation ​

Generate images from the cover, background, inline image and workspace avatar dialogs. Pick the provider and model in the dialog; Aurora shows an estimated cost before you generate. Generated images are stored in Aurora, so they don't depend on temporary provider links. When you generate several, pick the one to use before saving.

Speech ​

Speech works only with your own provider key; built-in speech is off during the beta. Choose providers for Speech to text and Text to speech in Settings → AI (OpenAI, Mistral or airouter.ch), along with the model and voice. Dictation records on your device until you stop, then sends the audio to your provider. Aurora doesn't keep the recording unless you add it as a file.

Usage Tracking ​

Open Settings → Account → Usage & cost to review your own-provider and AuroraAI usage. AuroraAI's allowance is tracked separately from the budget you set for your own providers.

Privacy Notes ​

  • AuroraAI does not use your prompts, retrieved context or outputs to train Aurora-owned models.
  • Requests to your own provider follow that provider's terms.
  • Avoid putting secrets or highly sensitive data into AI prompts unless that matches your own data policy.

Aurora is in public beta and free while beta.