Writer help
A little help.
Then back to writing.
From your first document to a workflow that feels like yours.
Read the full user guideGetting started
How do I install Writer?
Download the DMG from Writer's download page, open it, and drag Writer into Applications. Eject the disk image, then launch Writer from Applications. Writer 0.1.5 is Developer ID signed and Apple-notarized; it does not need the older alpha's Open Anyway workaround. You need an Apple Silicon Mac running macOS 13.5 or later. Intel Mac and Windows downloads are not available.
Why does the signed app ask for Keychain access?
macOS may ask the signed app for access to a connection saved by an older development or unsigned build. Signing does not automatically grant access to existing Keychain items. For the Writer copy you trust in Applications, Always Allow remembers access to that item; Allow permits only that request. Enter your login Keychain password only in the macOS dialog. If it keeps asking after Always Allow with the same signed copy, contact support with the version and item name. Do not delete your entire Keychain.
How do I start my first document?
Open Writer and use the document controls to create a file in a folder you choose, or open an existing document. Start with a few notes or a draft. You do not need to connect an AI provider to write, edit, and save locally.
Where do I find the latest release?
Use Writer's download page to check release availability, supported Mac architecture, version, and SHA-256 checksum. The page also explains the current release's signing status and macOS installation steps. Only install a copy from a source you trust.
Documents & export
Where are my documents saved?
Writer saves documents locally in the folder you select. The app supports creating, opening, and autosaving local documents. Keep a backup of that folder using your preferred backup tool.
What does 'This file changed on disk' mean?
Writer found a different saved version while you had unsaved edits and pauses saving. Preserve any text you need before choosing: Reload uses the disk version; Keep mine saves your current edits over it. Creating a file in a different folder should not itself cause this warning. If it repeats without an external change, check for another open Writer copy or editor using the same file and report the issue.
Can I import a blog from its URL?
Use Open document → Import a blog from URL, paste a public article URL and choose Import blog, then review the imported Markdown copy. Writer extracts article text and supported images rather than the whole website layout. Successfully downloaded images are linked from the current document folder's hidden .writer/assets folder. Keep that folder with the document when moving or backing it up, and review notices for images that could not be imported.
Can I work with Microsoft Word documents?
Yes. Writer imports and exports supported DOCX content, including headings, paragraphs, lists, basic tables, and raster images. It does not preserve every Word layout feature. Headers, footers, comments, and Word tracked changes do not round-trip. Review the exported file before delivery. DOCX imports are limited to 32 MB.
Can I keep my writing in Markdown?
Yes. Markdown is a native document format in Writer. You can keep your writing in ordinary files and open those files with other compatible tools.
Canvas & references
What is the canvas for?
The canvas gives you space beside the document to work on alternatives and individual sections. Send selected material to a frame, choose Open chat, and develop it there. Bring back the entire latest output or select only the text or supported items you want, then use the arrow toward the editor. Use whole frame clears a partial selection. Transferring content alone does not start an AI request.
How do I open a frame conversation and see its output?
Click Open chat on the frame or double-click its header. Output and Conversation stay visible together, with independent scrolling and a divider you can resize. Each frame keeps its own conversation and unsent reply. Use New response to jump from older messages to the latest reply. Back to canvas or Escape returns to the overview. Double-clicking output text selects a word instead of opening chat.
Can I compare or restore an earlier frame result?
In Open chat, use Output version or a message's View version link to inspect an earlier result. Compare shows it beside the latest output. Restore makes it a new latest version without deleting the history. Older versions are read-only; choose Back to latest or restore before sending a new request or transferring output to the main editor. Main-editor Undo is separate from frame output history.
Can I use a folder as shared document context?
Writer currently attaches individual files and keeps managed local copies; it does not continuously index a linked folder. Add shared files through the toolbar's Document context paperclip. Frames use those document references by default, or you can choose a subset in a frame's source selector. Attach frame-only material with that conversation's paperclip. Reattach a newer copy when the original source changes.
Which reference files can I add?
Document references support PNG, JPEG, GIF, WebP, PDF, DOCX, TXT, Markdown, CSV, and JSON. A context can hold up to 12 files, with a 10 MB limit per file. Writer keeps local reference copies with the document context. Adding a file does not automatically send it to an AI provider.
What if a reference cannot be read?
Review the extraction preview and retry if extraction fails. If references could not be loaded, choose Retry loading in the frame chat; reopen the document if the error persists. Retry, remove, or exclude failed sources before sending. Image-only PDFs may not contain usable text; export XLSX workbooks to a supported format such as CSV first. Successful extraction does not mean the app has checked facts or verified an analysis.
Website Editor & publishing
How do I turn on Website Editor?
Open Settings with the gear or Command-comma, then turn on Website Editor. Website appears beside Write and Augmented. Open it to create a page or import a URL or HTML file. Website Editor is off by default; turning it off keeps your saved pages and connection.
Can I edit a website page in its original design?
Design shows a local snapshot with supported styles and captured assets. Edit mapped headings, paragraphs, and list text in place, or open View and choose Text for the same draft. Use desktop, tablet, or mobile widths to review it. Imported pages are static snapshots: scripts and form submissions are disabled, and dynamic content or some layout details may differ. Importing or editing a page does not change the live site.
Where do I edit the SEO title and sharing image?
Open Page actions (the three-dot button), then Page information. Edit the title, description, canonical URL, robots directives, and Open Graph fields, including the sharing image URL and alt text. Save page details stores changes locally. Search and sharing previews are estimates; search engines and sharing services may display them differently.
How do Review and Canvas work for a website?
Review holds Content and SEO suggestions that you explicitly request with a configured AI connection. Inspect a suggestion before applying or dismissing it. Canvas gives you room to work on a selected page section and return supported changes to the draft. Sending a section to Canvas does not start an AI request. Preview and undo help you check changes before keeping them.
Can I open pages and brand references from Robynn?
Yes, when the connection is enabled for your workspace. Choose Open from Robynn, connect through the browser and select a site. In Pages, select one or several pages, choose Download selected, then Open downloaded to edit locally. Cloud audit shows the site's saved report; Refresh report does not run a new audit. Choose which brand references to use. Connecting alone does not start AI analysis or share all your local files. Availability depends on workspace access and supported page content.
Can I publish an article from Writer?
Open Publish beside the document title and choose Continue with Robynn. Older connections with website access offer Enable publishing to request article permissions; expired or revoked access offers Sign in again. Check the displayed workspace and use Switch account or workspace if needed. Connected publishing is included with Robynn Growth and requires an enabled workspace and supported WordPress site with the Robynn bridge. If website setup is missing, a publishing destination must be configured in Robynn. Prepare a private article preview, inspect it, request review, then choose Publish article when approved. Opening the panel or autosaving does not upload the article. Publication and verified delivery are separate results. This workflow does not publish arbitrary Website Editor HTML or Shopify pages.
AI, skills & extensions
How does AI work in Writer?
Connect a supported provider in Writer's settings, then choose when to make a request. The provider, account method, and model determine availability and cost. Basic local writing remains usable without an AI connection. Review AI output and its sources before using it.
Can I connect a Google Gemini account instead of an API key?
Settings → Google Gemini has a separate Code Assist account connection intended for eligible organization accounts. Choose Sign in with Google and add a Cloud project if your organization requires one. Writer attempts to load models after sign-in; use Load models or Refresh if the list is missing, then select an offered model. A browser success page or saved sign-in does not guarantee model access. Google controls eligibility and quota. The API-key route stays separate. The full user guide links to Google's current account guidance.
What happens if my Google account model is unavailable?
Writer keeps the selected model visibly unavailable rather than replacing it. Use Load models or Refresh to retry model discovery, or Reconnect Google if authentication is needed. A connection error does not fall back to an API key. Image generation is unavailable through Writer's Code Assist account route. If a frame cannot safely resume, keep its local history and start a new frame with the material you choose.
What are custom skills?
Skills are writing instructions you install as Markdown files. They can describe your editing preferences, structure, or house style. Writer applies loaded skill instructions to subsequent AI requests. A skill is guidance for the model, not a guarantee that it will follow every instruction.
What should I know before installing an extension?
Extensions are executable code that can add tools to Writer. Install them only from authors you trust. The current extension system is not sandboxed. Follow the extension's installation instructions and restart Writer after adding it.
Privacy & plans
Can I write offline?
Yes. Local writing, editing, and saving do not require an AI service. Cloud AI requests and other network-dependent tools need a connection. Your model provider's privacy and retention terms apply to material included in a request.
Are my documents automatically shared with Robynn?
No. Connecting Robynn is an explicit action. You choose the page, brand references, company workflow, or article revision used in that workflow. Preparing a connected article sends that selected draft and its included images for private review. Installing Writer or connecting a workspace does not upload every document in your folder.
What anonymous information does Writer measure?
Anonymous measurement is limited to installer download requests and one install count, with the app version, platform, and architecture. These counts do not include your writing, in-app activity, or account information. Writer pages do not use browser analytics or session replay.
What does Robynn Growth include?
Writer is free. Robynn Growth is $129 per month with 300 credits every month and all Robynn features enabled. Connect your Robynn workspace to use brand context, company knowledge, website pages, saved SEO / GEO audits, company article workflows, and article preview, review, and supported WordPress publishing. Your local Writer files remain available without a Growth subscription.
Something else on your mind?
Tell us what you were trying to do and what happened. Please leave out API keys, private source material, and confidential documents.
Contact the Robynn team