KosshiKosshi

1.20.0 (beta)

Kosshi 1.20.0 reorganizes the sidebar and formatting controls, and Search can now narrow rows by tag values and dates. The sidebar also adds a Dates section for browsing rows by date.

Important: Date Input Settings

You can now choose separate regional input formats for full dates and yearless dates, such as MM/DD or DD/MM. Both default to the format used in your region. For example, @tag(9/12) means September 12 with MM/DD and December 9 with DD/MM. If the settings have changed, existing ambiguous dates may be interpreted differently.

After updating, open Settings > Tags > Date Input and confirm the current settings.

Redesigned Search

Search is now above the outline and can find rows by @tag values.

For example, you can find @status:done, search a numeric value such as @estimate:>=3, or look for dated tags with date:today and @deadline:2026-09-10..2026-09-20. Use @deadline:today to search only @deadline tags, or date:today to search across all dated tags.

Search across dated tags to show today's tasks in the outline.

The filter menu in the Search field adds common conditions. The Search field also offers completions, so you can write conditions with just the keyboard.

Matching text, tags, and dates are highlighted. Conditions without specific text, such as is:incomplete, highlight the whole row.

You can still save a query with the bookmark button beside the search conditions. For example, save date:today as Today’s Tasks, date:this-week as This Week, or a tag query as a project view. The saved query appears in the sidebar and can be reopened without rebuilding its conditions.

Choose Show Count from a saved search’s context menu to show its current number of matches in the sidebar. For example, save date:today and show its count to see how many tasks are left today from the sidebar. The count updates as the outline changes.

The sidebar shows the current number of matching rows beside the saved search.

Browse Dates in the Sidebar

The sidebar has a new Dates section. It appears when a row has a date in an @tag, such as @due(10/10) or @due(2026-10-10). Rows with dates are listed by year, month, and day. Select a year, month, or day to apply a search for that period, such as date:2026-09. Today's date is marked with a dot.

Select a month to show only the rows with dates in that month.

By default, dates before the current month are hidden. Use Past Dates in Settings > Appearance > Display > Sidebar to choose whether past years, months, or days are hidden.

You can also choose which sections appear in the sidebar. Turn off Show Bookmarks, Show Searches, Show Dates, or Show Tags in the same settings to hide sections you don't use. To switch them from the sidebar, right-click a heading or empty space on macOS, or touch and hold on iPhone or iPad.

Preview: Read the Outline as a Document

Choose Preview from the menu at the upper right of the editor to read the current outline as a document beside it. You can keep editing the original rows while reading, printing, or sharing the result.

Choose a file format from the menu on the left: Markdown, Rich Text, TextBundle, Plain Text, or OPML. The button beside the menu switches between the rendered Preview and the generated Source. Use Source to check the exact text that will be exported.

Preview shows the outline as a document while you keep editing.

When the Headings beta is enabled, Preview and exports keep the outline structure as document headings.

Backlinks: Find Referencing Rows

Turn on Settings > Appearance > Display > Backlinks and Kosshi shows a count beside a row when other rows refer to it. Select the count to open Search with the referencing rows already collected.

The results highlight the linked text. Select a result to jump directly to the row where the reference was written. You can also build the query yourself with backlinks: when you want to combine it with other search conditions.

A count beside a row shows that other rows refer to it.
Select the count to find the source rows and jump to a reference.

Formatting Bar

The formatting menu that used to be in the upper-right corner of the editor has been replaced with a Formatting Bar below the outline. On Mac, choose Show Formatting Bar from the menu at the upper right of the editor, or turn it on in Settings > Appearance > Display.

Use it for Bold, Italic, Highlight, checkboxes, blockquotes, tables, and links. The menu adds Prose, Strikethrough, Code, Code Block, Math, Math Block, and Image. The link and image controls open a small form for the URL and optional display text. When the Headings beta is enabled, the bar also offers # and % for headings and document comments.

On iPhone and iPad, the same editing actions are available from the keyboard toolbar while you edit.

Apply common Markdown formatting without leaving the outline.

Headings Beta

Headings is a beta feature that uses outline levels as document headings. Enable it from Settings > Beta. A row beginning with # becomes a Markdown heading, and a row beginning with % becomes a note that is left out of Preview and exports.

Heading levels come from indentation, not from the number of # characters. See the Heading guide for details. Because this is a beta, the behavior and presentation may change.