The Kasava Plan Editor is a powerful rich text editor with slash commands for inserting content and embedding references to your project data. This page documents the editor features and slash commands available when editing Plans.
For information on creating Plans with AI, managing Plans, and publishing, see Plans (PRDs) . Accessing the Editor To edit a Plan in the rich text editor:
Navigate to a Plan
Click Plans in the sidebar and select a Plan from the list.
Switch to Document View
Click the view toggle in the Plan header and select Document view.
Start Editing
The Plan opens in the rich text editor. Click anywhere to start typing or use slash commands. Editor Features The Plan editor includes:
Rich Text Formatting - Headings, paragraphs, lists, bold, italic, and moreCode Blocks - Syntax-highlighted code snippetsMedia Embeds - Images and YouTube videosProject References - Embed links to code, issues, PRs, and other project dataAuto-Save - Changes save automatically as you typeVisual/Markdown Toggle - Switch between visual editor and markdown editingWidgets Sidebar - Drag and drop widgets into your documentSource Attribution - View AI generation sources for generated Plans
Slash Commands Type / anywhere in the editor to open the command menu. Start typing to filter commands by name or keywords.
Basic Blocks Command Keywords Description /textp, paragraph Insert plain text paragraph /h1heading, title, big Large section heading /h2heading, subtitle Medium section heading /h3heading Small section heading /h4heading Sub-section heading /h5heading Minor heading /h6heading Smallest heading /bulletul, list, unordered Create a bullet list /numberedol, list, ordered Create a numbered list /tasktodo, checklist, checkbox Create a task list with checkboxes /quoteblockquote, citation Add a blockquote /codesnippet, programming Add a code block
Command Keywords Description /imagephoto, picture, img, media Upload or embed an image /youtubevideo, embed Embed a YouTube video /gifgiphy, animated, meme, reaction Search and insert a GIF
These commands embed references to your project data. When you use a widget command, a selector dialog opens to search and select the item to embed.
Issue Trackers & Dev Tools: Command Keywords Description /bugissue, error, problem, report Insert a bug report from Kasava bug tracker /github-issueissue, github, ticket Insert a GitHub issue /prpull, request, merge, review Insert a GitHub pull request /commitgit, change, sha, revision Insert a Git commit reference /linearissue, ticket, task, project Insert a Linear issue /jiraissue, ticket, atlassian Insert a Jira ticket /asanatask, project, todo, work Insert an Asana task /trellocard, board, list, kanban Insert a Trello card
Code & Design: Command Keywords Description /code-samplecode, file, snippet, repository, source Insert code from a repository /prototypedesign, figma, v0, mockup, builder, preview Insert a prototype link (Figma, v0, AI Builder)
Communication: Command Keywords Description /gongcall, recording, sales, conversation, transcript Insert a Gong call recording /intercomticket, support, conversation, customer, chat Insert an Intercom conversation /slackmessage, thread, channel, discussion Insert a Slack message /teamsmicrosoft, message, thread, channel Insert a Microsoft Teams message
Documentation: Command Keywords Description /planlink, document, reference, spec, prd, cross-reference Link to another Plan /notionpage, document, wiki, doc Insert a Notion page /confluencepage, atlassian, wiki, document, space Insert a Confluence page
Product Intelligence: Command Keywords Description /goalobjective, target, milestone, okr, kpi, metric Insert a product goal /decisionchoice, outcome, adr, architecture, technology, rationale Insert a product decision /updatestatus, digest, progress, weekly, summary, report Insert a product status update /insightai, observation, recommendation, analysis, pattern, risk Insert an AI-generated insight /mixpanelanalytics, board, report, metrics, data, chart Insert a Mixpanel board
Command Keywords Description /boldstrong, b Make text bold /italicemphasis, i Make text italic /underlineu Underline text /strikestrikethrough, cross Cross out text /inline-codemonospace Format as inline code /highlightmarker, yellow Highlight text /superscriptsup, power Make text superscript /subscriptsub Make text subscript
Alignment Command Keywords Description /align-leftleft Align text to the left /align-centercenter, middle Center align text /align-rightright Align text to the right /justifyjustify Justify text
Structure Command Keywords Description /dividerhr, line, separator, horizontal rule Insert a horizontal divider
Project reference widgets create rich embeds that display live information from your connected services. Here’s how to use the most common widgets:
Bug Reports Use /bug to embed a bug report from the Kasava bug tracker:
Type /bug
The bug selector dialog opens showing your recent bug reports.
Select a Bug
Search or browse to find the bug report you want to embed.
Insert
The bug report is embedded showing title, severity, and summary. GitHub Issues and PRs Use /github-issue or /pr to embed GitHub references:
Issues display title, state, labels, and assigneesPull Requests display title, state, reviewers, and merge statusBoth include repository context and direct links
Code Samples Use /code-sample to embed code snippets with full context:
Type /code-sample
The code file selector opens.
Select Repository
Choose from your indexed repositories.
Navigate to File
Browse the file tree or search to find the code.
Select Lines (Optional)
Optionally select specific line ranges to embed.
Insert
The code snippet is embedded with file path, line numbers, and syntax highlighting.
Product Goals and Decisions Use /goal and /decision to embed product intelligence:
Goals show progress percentage, status, and target datesDecisions show outcome, rationale, and decision makerBoth link to the full record for more details
Status Updates Use /update to embed product status digests:
Shows period covered and executive summary
Displays accomplishment counts and risk indicators
Links back to the full status update
AI Insights Use /insight to embed AI-generated observations:
Shows severity level (info, warning, critical)
Displays category and confidence score
Includes suggested actions when available
Editor Controls Visual vs Markdown Mode Toggle between visual and markdown editing:
Open Mode Selector
Click the Visual Editor / Markdown toggle above the editor.
Switch Modes
Visual Editor - WYSIWYG editing with formatting toolbarMarkdown - Edit raw markdown with preview Access additional widgets and an AI chat assistant via the sidebar:
Open Sidebar
Click Show Widgets button above the editor.
Choose a Tab
The sidebar has two main tabs:
Chat - AI assistant to help write and refine contentInsert - Browse and insert widgets by category
Browse Insert Categories
In the Insert tab, widgets are organized into categories:
Bugs - Bug reports from your trackerIssues - GitHub issues from connected repositoriesCode - Code samples and snippetsProto - Figma designs, V0 prototypes, and AI Builder prototypesDesign - Import Figma files (requires Figma integration)
Insert Widget
Click a widget to insert it at your cursor position, or drag and drop it into the document.
Chat Assistant The Chat tab in the widget sidebar provides an AI assistant:
Ask questions about your Plan content
Get help writing sections
Request revisions or improvements
Generate content suggestions
The chat maintains context about your Plan and can help you refine your document.
Source Attribution For AI-generated Plans, view the sources used during generation:
Open Sources Panel
Click Show Sources button (appears for AI-generated Plans).
Review Sources
The sidebar displays:
Bug reports analyzed
Issues and PRs referenced
Code files examined
Other context used in generation
Saving Changes Changes save automatically as you type. You can also:
The editor shows “Saving…” when syncing changes
A confirmation appears when save completes
Switch back to Structured view to see your changes reflected
Best Practices Use headings for structure - Break your plan into clear sections with H1, H2, and H3 headings. The Structured view uses these to create section navigation.
Embed references liberally - Link to relevant issues, PRs, and code to provide context. Widgets create rich, clickable embeds.
Include goals and decisions - Document the “why” alongside the “what” for future reference. Use /goal and /decision widgets.
Add task lists - Use /task to create checkbox lists for tracking implementation progress.
Use keyboard shortcuts - Type / at the start of a line to quickly access commands. Filter by typing the command name.
Keyboard Shortcuts Shortcut Action /Open slash command menu Cmd/Ctrl + BBold text Cmd/Ctrl + IItalic text Cmd/Ctrl + UUnderline text Cmd/Ctrl + Shift + SStrikethrough Cmd/Ctrl + SSave (auto-save is enabled) TabIndent list item Shift + TabOutdent list item
Plans (PRDs) Create, manage, and publish Plans
Implementations Convert Plans to actionable work items
Products Link Plans to Products
Integrations Connect GitHub, Linear, Jira, and more
