AI actions are inline edits run on a text selection. Highlight a sentence, click the AI button (or hit ⌘K), pick an action. The selection is replaced with the result.
These are small operations — a paragraph, a sentence, a heading. For generating an entire page, see Generate with AI.
The actions#
Improve
Tightens prose. Removes filler, fixes awkward phrasing, keeps the meaning.
Expand
Adds depth. Useful when a paragraph is too terse and needs supporting detail.
Summarize
Compresses a long passage to its essentials.
Fix grammar
Mechanical corrections only. Doesn't change voice or structure.
Translate
Translates to a target language while preserving Markdown structure.
Change tone
Shifts to friendly, formal, technical, or casual.
How to use#
Select the text you want to change
Drag-select or use ⌘A for the whole block.
Open the AI menu
Either click the sparkle button that appears above the selection, or hit ⌘K.
Pick an action
Or type a free-form prompt — "make this less formal", "add a code example after this", "shorten by half".
Accept or regenerate
The result appears in place of the selection with Accept, Reject, and Try again buttons.
Free-form prompts#
The fastest way to use AI actions is to skip the preset and just type what you want:
- "Add three more bullet points about error handling"
- "Convert this list to a Steps component"
- "Make this sound less marketing-y"
- "Add a callout warning about rate limits"
The AI sees the selected text, the surrounding context, and your prompt. It returns MDX that the editor inserts in place.
Credits and pricing#
Inline actions are cheap (small input, small output). On the Free plan you get a small monthly allowance. Starter and Pro include monthly credit buckets that cover normal writing — see AI credits.
If you run out of credits mid-session, the action button shows a "Top up" prompt. Refunds are automatic if a generation fails.
Bringing your own Anthropic API key (BYOK) is available on Enterprise plans. On Free / Starter / Pro, AI runs on Dokly's API allocation and counts against your monthly credit bucket.
What the AI sees#
For privacy and accuracy:
- The AI receives only the selected text plus a small context window (the few blocks before and after).
- The AI does not see your other pages, your account info, or any reader analytics.
- Prompts and outputs are not used to train any model.
If you need stricter handling (zero retention, regional inference), reach out about Enterprise.