Workspace

Home

The Home tab summarizes what you can continue today: recent files, today's journal, running agents, due dates from kanban boards, and the unprocessed inbox. Everything is read directly from the Markdown files in the work folder, without a database.

Opening Home

• Home opens by itself when Markwork starts without saved tabs, and when the last tab is closed.
• Alt+Home or the ☰ menu → Home opens it at any time. There is only one Home tab, marked with a house icon.
• The Home tab is recorded and restored together with the file tabs.
• Do not want Home to appear by itself? Turn off Home in Preferences (Ctrl+,). After that, closing the last tab empties the document as before.

What Home contains

• Continue: up to three cards of the latest files, one card per folder, so that every card represents a different place of work.
• Journal: the Today's journal row with the number of notes and activities of today. Click it to open the journal, or the + button for a quick capture. It is shown when a work folder is open.
• Agent: @pi cards that are working, queued, or waiting for your answer. Click a waiting row to answer right away; a working one opens its log; a queued one opens its board. This section is only shown when an agent is running.
• Due dates: cards from all the kanban boards in the work folder that are not finished and whose due date ([due:: YYYY-MM-DD}) is overdue, today, tomorrow, or the day after. The status is written as text (2 days overdue, Today, Tomorrow), not only a color. Cards in the Done column or already checked are not included. The project name is taken from the #project/… tag or the project: frontmatter of the board.
• Inbox: an inbox file that still has unchecked items, with their number.
• Recent files: other files that were opened recently, with their folder and age.

Finishing tasks

Check the box in front of a task to mark it done: Markwork writes [x] to the card on its board. If that board is open, the change goes through its editor as one undo step. The task stays visible until Home is redrawn, so a mistaken check can be undone right away. If the card has changed since Home was read, the check is rejected and the board is not touched. Click the task title to open its board.

Where the data comes from

• Due dates and the inbox are read from the Markdown files in the open work folder (using a cache by modification time, at most 300 files). An unsaved tab is read from its editor.
• The list of recent files is stored in the settings (recent-files, 30 files).
• Home is recalculated every time it is shown, when the window becomes active again (for example after git pull or an edit from another editor), and when the status of an agent changes.