Before you start
Connect an AI provider with your own API key. See Connecting an AI provider. If you open the assistant before connecting one, it offers to connect one on the spot.Open the assistant
In the editor, select Assistant (the sparkle button) in the editor bar, beside the clock button, or press ⌘ J (Ctrl J on Windows and Linux). Press it again, or select Close the assistant (×) in the panel, to close it.
Review a pending edit on a fictional guest sample
- In the command bar (⌘ K), type a question and choose Ask the assistant. Outside the editor, choose the document first. The question appears in its composer; review it and press send when ready. See Using the command bar.
Ask for a change
Pick a suggestion or write your own
Let it read and reply
"## Languages" remains ordinary text.
Outside translation, some fields, including existing dates, website fields, keyword lists and page language, still need Write or Design. Select Open Write in the assistant: Basics holds name, headline and contact details; each section holds its entries; Add section adds a missing section. You can also import an old resume from Documents to fill a blank resume.
For another language, choose Translate into… in the document menu or assistant, pick a language different from the source’s page language, then choose Create language copy. The source language is excluded from the picker. Your original stays unchanged. The private copy uses that page language for generated headings, date words and text direction. It opens the assistant with an unsent request: choose your connection, check what will be sent, then press Send. Creating the copy makes no AI call.
Translations of visible text—including explicit headings, keywords, nested roles, custom fields and link labels—come back as one set to review before accepting. Formatting, link destinations, email addresses, phone numbers and structured dates stay intact; proper names and facts should retain their meaning. Hidden content and private notes stay in the copy, untranslated, and are not sent for translation. Changes to name fields and figures are flagged for you to check. Check names, figures, meaning and layout before accepting; a proposal is not a guarantee of translation quality. If the resume changes, ask for a fresh set. Oversized or incomplete translations are refused rather than silently presented as complete.

Create a separate language copy before requesting translations. Fictional resume; translations require a chosen AI connection and Send.
Review proposed edits
A text-only suggestion shows where it lands (for example, Summary · paragraph 1), the current text struck through, the new text highlighted, and a short reason. These text changes are also marked on the page, with a proposed badge in their section. A request involving fields, entries or sections appears as one card for the entire supported set. The card lists the affected entries and roles, the current field values, the proposed values and the reasons. New entries show their stored fields, including date facts and link destinations. Review this card before accepting: the page previews the proposed resume, but structural changes do not have the individual old/new markings or section badges used for text-only suggestions.
A headline and a new certification, reviewed together as one structural set

Review a pending edit on a fictional guest sample

The proposed edit card when tailoring: the assistant's reading of the posting's requirements, with two gaps left open, then the edit, its citation to check, and details nothing checked backs
- Select Accept to apply a text edit or an entire structural set, or Reject to dismiss it. A rejected edit shows Rejected · Undo; Undo makes it undecided again.
- With more than one edit waiting, Reject all dismisses them together.
- A decided edit folds to one line with its number, where it landed and what happened. Select Show to open it again.
- For text-only suggestions with more than one edit waiting, Accept all applies the edits it can still place. The notification counts those edits and tells you how many could not be placed. A structural set has one Accept control for all its changes.
- With an edit focused, press A to accept, R to reject, and ↑ ↓ to move between edits.

Reviewed wording on a fictional resume, reopened after accepting and reloading.

Page-fit measurement before accepting: this fictional one-edit set stays at five printed pages, with no change in estimated overflow.

Accept all placed two edits; the competing rewrite could not be placed
Tailoring to a posting
Tailoring changes a copy of your resume made for that job, never the resume your other applications use. If the open resume isn’t that copy, the assistant shows Copy for this job above the message box and won’t propose edits that use the posting until you copy it, or leave the posting out. Edits it proposed with a posting can’t be accepted on a resume that isn’t that job’s copy: copy the resume for the job and ask again there. Edits from older conversations that may have used a posting show as out of date and can’t be applied anywhere; ask again on the resume you want to change. Tailoring started through MCP or the public API uses this same review flow. Its new copy starts unchanged, and its conversation holds pending proposals or questions. Review them here on web or mobile before accepting; Undo uses the normal editor history. This route sends the resume and posting without private notes, Knowledge or web access. If generation fails or is stopped, the unchanged copy remains in Documents so you can continue its conversation. Submitted application document links stay intact. The originalresumeId and name response fields still identify the copy; they do not mean generated edits were accepted.
- The assistant’s reading of n posting requirements: the requirements it found in the posting (and any the application lists), marked An edit addresses it, Cited as already shown · check it, No evidence found · left as a gap or Not assessed. Tick a gap to mark what you want to discuss; untick it to clear your choice. Ticking does not supply evidence, change its assessment, or change your resume. Gaps stay open, even when no edit could be placed; the assistant doesn’t fill them with experience you don’t have. It can miss requirements in a posting’s text, so read the posting too.
- Posting asks for: the requirement an edit addresses.
- The assistant cites n sources · check they say this: the passages, or Knowledge facts, the assistant pointed to. A citation is the assistant’s pointer, not proof; read it before you accept. Nothing cited for this edit means it pointed to nothing.
- Nothing checked backs these. Confirm each before accepting: what the model flagged, plus numbers and years unless one statement in the entry (or role) being edited says all of them with the same subject words (longer words, and short names such as AWS), and words that aren’t anywhere in your resume. A reworded claim can be flagged too. These checks find likely problems; they can’t confirm an edit is true.

Tick a posting gap to mark it for discussion; its assessment stays Not assessed. Fictional resume and job.
Use Knowledge
Turn on Knowledge in the message box to let the assistant look up your switched-on Knowledge facts and cite them. It’s off for each new conversation. When it’s on, facts the assistant looks up are sent to your AI provider with that message. Once a reply looks up Knowledge, that reply and every later one in the conversation are treated as using it, because they can repeat it. They aren’t sent again with a message that leaves Knowledge off. If you later correct, switch off or forget a fact, those replies are hidden from the conversation and never sent again, and a reply waiting on your answer has to start over.Undo an accepted edit
Accepting shows a notification with the number of edits applied and Undo. You can also press ⌘ Z (Ctrl Z) like any other change, or use History to restore an earlier document. An edit you explicitly undo becomes pending again when its original passage is available, so you can accept it later. That decision is saved with the document, even if you close the assistant. If an unsaved decision is recovered after another tab or device saved a newer version, saving pauses for the usual conflict controls; matching text alone does not choose which decision to keep. See Undoing changes and version history. Accepted edits keep the reply’s recorded AI request sources with your resume or letter, including through save, recovery and Undo. Other accepted edits from the same reply keep their source when you undo just one. Pending or rejected edits add none. Connection changes or deletion do not rewrite the original provider and model; accepting a saved edit makes no new AI request. See AI usage.Answer a question
When the assistant needs a fact or a choice from you, it shows a blue question card with a few answers. Select one, or type your own under Or in your own words… and select Send. The assistant then continues with your answer. After answering, Remember opens a review of your answer for Knowledge. Edit the fact and its type, choose whether it stays private to the selected application, then select Remember again to save. Cancel saves nothing. This is an explicit statement you review, not verified evidence or automatic memory; it sends nothing to AI and leaves your resume unchanged.
Review your own answer before saving a fact. Fictional answer; no Knowledge write until Remember.

Answer a clarifying question before continuing
Choose what’s shared with each message
Above the message box, chips show what goes with your next message: the document, and the job posting when the document is linked to an application. Select the × on a chip to leave it out, including before your first message. A chip you left out stays as a dashed outline; select it to send that item again. Without the document, the assistant can’t read or edit it for that message. The line under the box always says what will be sent and to which provider, names any attached files, and mentions earlier messages only once there are some. Nothing is sent until you press send. A long pasted message folds to its first lines in the conversation, with Show all. Before sending a long paste, Attach a file instead offers to upload those words asmessage.txt, using the existing destination approval. After a successful upload, the unchanged message box says Read the attachment; text you typed while it uploaded stays intact. A failed upload keeps your paste. Review the named file and disclosure, then press Send yourself. Removing the file releases its upload before the next message. Unsent uploads stay with their conversation. Reopening it on web or mobile restores their named chips, including an upload that finished while you changed accounts. Review or remove those files before sending; reopening never sends them to a provider.
Removing either context chip also leaves earlier conversation history out of the next reply. Pending questions or approvals from a different context cannot resume; send a new message with your current choices.
The Knowledge chip is off by default. Turn it on for a message to let the assistant search your shared facts and stories, plus Knowledge private to the selected application when its posting is shared, read-only, for example “Add my conference talk from Knowledge”. The line under the box then says what it finds is sent too. It can’t change Knowledge; facts private to another application never appear. If you later correct, switch off or forget a fact, messages written after the assistant first searched Knowledge, up to that change, aren’t sent again.
From Career → Coach or a job’s coach, Add to resume under an answer opens a resume’s assistant with that answer in the message box; in a job’s coach, that job’s copies are listed first. The answer is handed over inside the app, not in the page address. Nothing is sent until you review it and press send, and the assistant proposes edits for you to accept as usual.
Under each reply, Used names what it read: the document, and any facts and stories its Knowledge search found. Select a chip to see them.
When you select Interview prep from an application’s detail panel, the assistant uses that application’s posting, even when several applications share the same resume.
Attach files
Select the paperclip in the message box to attach files, such as a job description PDF or your notes. You can attach them before your first message or later in the conversation. The file picker offers the types the assistant can read. Each file shows as a chip; select its × to remove it before sending, which also deletes the uploaded file. On the web, the file stays in the box until removal is confirmed. Sending and further file changes wait while removal is pending. If removal fails, your message and file stay available; select × again to retry. The same applies in Career and application coach conversations. Files already sent stay with their messages until you delete the conversation.
A failed web removal keeps the fictional job-notes file and unsent message available for retry.
- Plain text, Markdown, JSON and Word (
.docx) files are read as text (up to the first 40,000 characters). A Word file’s page headers and footers are read too. If a Word file is damaged or has no text, the step shows Couldn’t read the attachment. - Images, PDFs and MP3 or WAV audio are passed to the model directly. Whether the model can use them depends on your provider.
- You can attach up to 10 files per message, each up to 25 MB, 100 MB per conversation and 1 GB across all your conversations. When you reach a limit, the message names it.
Search the web
If you connect an optional Web access service in Settings → AI → Web access, the assistant uses that selected service for search and enhanced reading. If your installation’s administrator set up server search, the assistant searches with it instead, with or without a connection. Web access then says Your server provides search for Applications and the assistant, and, until you connect a service, Test search checks it. Without a connection, the assistant can read supplied public URLs with the built-in reader or work from text you paste. See Assistant tools. You can also supply a public page URL: the assistant uses the selected reader or built-in reading. Page reading does not require a separate search account. Failed reading leads to pasted-text recovery; clipped or incomplete pages are identified before you rely on them. In a resume conversation, a successfully read page offers Save as a job… beneath its Sources link. Enter the company and role, check Saved description, then choose Save and link this resume. This saves the retained posting snapshot and its reading source, links the open resume, and switches on that posting’s context chip for your next message. It does not read the page again or make another AI call. Search snippets and failed reads do not offer this action. Cancel saves nothing before confirmation. If saving succeeds but linking fails, retry the same confirmation to finish linking the saved application. When a link’s response is lost, the app reads the stored link before confirming it. If that check fails, retry rechecks the same saved application. The posting chip switches on only after linking is confirmed. This action links the current resume rather than making a copy; use Copy for a job first when you want to keep it separate from your base resume. Clipped or incomplete snapshots keep that warning. Page text remains external content to review, including anything that looks like an instruction.
A fictional page read offers explicit posting review and save/link beneath its source. The company and role need confirmation before anything is saved.

Removing a saved web connection asks first; this example uses fictional local credentials
Switch models
The model chip in the assistant’s header shows the model in use. Select it to choose another connected provider and approve transferring earlier messages on your next send, or choose Connect another… to add one right there, over the conversation. Back to the conversation returns with your message as you left it.
Choose a model available through your provider
Stop, retry or copy a conversation
- Stop a reply with the stop button that replaces send while the assistant is working, or press Esc in the message box. If it stopped before proposing anything, you’ll see Stopped. No edits were proposed. with Continue.
- When a reply fails, your message is kept. Select Retry. Switch model appears when the provider caused the failure, such as a rejected key, a missing model or a rate limit. A lost internet connection says Couldn’t reach Reactive Resume instead.
- Copy transcript at the end of the conversation copies the messages as plain text, speaker by speaker, with each proposed edit (where it lands, old and new text, and whether you accepted it), each question with your answer, and the retrieved source links.
Past conversations
Each conversation belongs to one document. Opening the assistant continues that document’s latest conversation. Select New conversation (the pencil) to start fresh, or Past conversations (the clock) to see earlier ones.
Reopen a saved conversation

An unavailable conversation link returns to Documents with an explanation
Related guides
Connecting an AI provider
Assistant tools
Tailoring a resume for a job
Writing a cover letter

Pending edits remain after an explicitly approved connection change.

An existing proposal remains actionable while its AI connection is Off.