Skip to content
Back to search

lazymark

Lazy markdown notes, tasks and a Kanban board in your terminal. With a sleepy sloth.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/MathiasDrizzy/lazymark with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/MathiasDrizzy/lazymark'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mathiasdrizzy--lazymark/badge.svg)](/listings/mathiasdrizzy--lazymark)

HTML

<a href="/listings/mathiasdrizzy--lazymark"><img src="/api/listings/mathiasdrizzy--lazymark/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install a [Nerd Font](https://www.nerdfonts.com/) in your terminal for the folder and note icons. Building needs Go 1.27.2 or newer.

**With Go**

go install github.com/MathiasDrizzy/lazymark/cmd/lazymark@latest

**From source**

git clone https://github.com/MathiasDrizzy/lazymark.git
cd lazymark
go build -o lazymark ./cmd/lazymark

**Homebrew (macOS)**

brew install mathiasdrizzy/tap/lazymark

**Prebuilt binaries** for macOS, Linux and Windows are on the [Releases page](https://github.com/MathiasDrizzy/lazymark/releases).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 272 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="assets/brand/reposo/hero.gif" alt="The lazymark mascot, a sloth with a pencil, waking up, waving, dancing, jumping and spinning in a loop" width="144" height="144">
  3. # lazymark
  4. **Lazy markdown notes, tasks and a Kanban board in your terminal.**
  5. Plain markdown files. Keyboard and mouse. Inline images.
  6. [![CI](https://github.com/MathiasDrizzy/lazymark/actions/workflows/ci.yml/badge.svg)](https://github.com/MathiasDrizzy/lazymark/actions/workflows/ci.yml)
  7. [![Go version](https://img.shields.io/github/go-mod/go-version/MathiasDrizzy/lazymark)](go.mod)
  8. [![License: MIT](https://img.shields.io/github/license/MathiasDrizzy/lazymark)](LICENSE)
  9. <img src="assets/readme/main.gif" alt="lazymark browsing a folder of notes, ticking a task, opening the key list, the Kanban board and the settings" width="100%">
  10. [Obsidian compatibility](#obsidian-compatibility) · [Install](#install) · [Quick start](#quick-start) · [Keys](#keys) · [Configuration](#configuration)
  11. </div>
  12. ## Why lazymark
  13. - **Your notes stay yours.** They are plain markdown files in one folder. Edit them with any editor; lazymark only rewrites the line you change and never overwrites a note that changed outside it.
  14. - **Learn it by looking at it.** Panels, rounded borders and a bar of keys at the bottom. Press `?` for the keys of the panel you are in.
  15. - **Keyboard or mouse.** Every action has a key. You can also click rows and the keys in the bottom bar, drag the divider between the columns and use the scroll wheel.
  16. - **Tasks come from your notes.** The Tasks panel lists the checkboxes you already wrote, and ticking one changes only that line.
  17. - **Safe by default.** Deleted notes go to a trash for 20 days, and folders with content always ask first.
  18. ## What it does
  19. ### Notes and folders
  20. One tree for folders and notes. Create, rename, move and delete with a single key; the cursor lands on what you just created.
  21. <img src="assets/readme/feature-notes.gif" alt="Creating a folder, a note inside it and renaming the note" width="100%">
  22. ### Templates and the daily note
  23. Put notes in a `templates/` folder and start new ones from them with `C`; `{{date}}`, `{{time}}` and `{{title}}` are filled in. `T` opens today's note, `journal/YYYY-MM-DD.md`, made from `templates/daily.md` the first time; `lazymark daily` does the same from the shell. See [docs/templates.md](docs/templates.md).
  24. <img src="assets/readme/feature-templates.gif" alt="Starting a note from the meeting template and opening today's daily note" width="100%">
  25. ### Tasks
  26. Every `- [ ]` and `- [x]` in your notes, in one list. `Space` ticks a task and rewrites only its line; `H` hides the finished ones, `a` tags the task under the cursor with the done tag (`#lm-done`, see below) so it hides by itself, and `A` shows what the tag hides. The panel title says how many are hidden ("3 hidden"). The preview shows the note at the task's line.
  27. <img src="assets/readme/feature-tasks.gif" alt="Ticking tasks in the Tasks panel and hiding the finished ones" width="100%">
  28. ### Dates
  29. Select a task, in the Tasks panel or on the board, and press `d`. A small popup asks for **Start** and **Due**: type a date the way you say it (`2026-10-09`, `today`, `tomorrow`, `+3d`, `+1w` or a weekday such as `friday`, in your interface language) and the resolved date appears next to the field before you save. Leave a field empty to remove that date, `Esc` cancels. On the board, clicking the dates of a card opens the same popup. From the shell, `lazymark task due <id> 2026-10-09` and `lazymark task start <id> …` do the same.
  30. <img src="assets/readme/feature-dates.gif" alt="Pressing d on a task, typing +3d and friday, and seeing the dates on the task's card on the Kanban board" width="100%">
  31. The completion date is added by itself when you tick a task. On screen the dates are monochrome glyphs (never emoji) in the color of their state, taken from the theme's palette: overdue in red, due soon (today, or the next N days) in the warning color, on time in the accent color, and completed in green. Turn the colors off with **Date colors** in Settings (`,`) or `date_colors` in the config, set how many days ahead counts as "due soon" with `due_soon_days`, and pick the color of each state in Settings; see [docs/configuration.md](docs/configuration.md). If you set a start date after the due date, the popup warns you (and saves anyway).
  32. **In the file** the dates go at the end of the task line, in a format that [Obsidian Tasks](https://publish.obsidian.md/tasks/Introduction) understands. By default lazymark writes the **Dataview** format (`[due:: 2026-10-09]`, plain ASCII, so it looks the same in any editor and on GitHub), and it always reads both that and the emoji format of Obsidian Tasks, including scheduled and created dates. To write the emoji format instead, set **Date format** in Settings (`,`) or `date_format` in the config. A vault that already has emoji dates and none in Dataview keeps writing emojis (lazymark tells you once, so formats do not get mixed). A task you edit keeps the format its line already had.
  33. To use Dataview dates in Obsidian, open the Tasks plugin settings and set **Task format** to **Dataview**; Obsidian Tasks reads one format at a time, so after that it will not read the emoji ones. To convert the notes you already have, run `lazymark dates migrate --to dataview --dry-run` to see the change and then without `--dry-run` to apply it (`--to emoji` goes back). It is never automatic, only touches task lines, writes each note atomically and a second run changes nothing. More in [docs/cli.md](docs/cli.md).
  34. ### Categories
  35. Inline `#tags` in your notes become categories; code fences, inline code, link
  36. destinations and frontmatter are excluded. `Enter` on a category shows only the
  37. notes that have it. See [docs/tags.md](docs/tags.md) for the parsing rules.
  38. <img src="assets/readme/feature-categories.gif" alt="Filtering the notes tree by the design tag" width="100%">
  39. ### Kanban board
  40. Each task is a card with a rounded border: its text (up to 2 lines), its note and its dates (set them with `d`, see Dates). Settings has "Cards: rectangles | compact" for the one-row view.
  41. The same tasks as columns: To Do, In Progress and Done by default. Move a card with `H` and `L` or `Shift+←` and `Shift+→`, or drag it with the mouse to another column: the card and the target column are highlighted while you drag, `Esc` cancels. Inside a column, `K` and `J` (or `Shift+↑` and `Shift+↓`) move a card up and down, and dragging it over another card of the same column does the same: it swaps the two tasks (each with its subtasks) in the note, so it works between sibling tasks of the same note; across different notes the cards always follow the order of the notes. The change is written back to the note, on that line only, and never over a note that changed outside lazymark (it reloads and tells you). `Kanban (W)` opens the board, `Notes (W)` and `← Notes (Esc)` go back, and the bottom bar lists what the selected card can do.
  42. **Keeping a long board readable.** `o` (or the `Hide done (o)` button in the top bar) hides the finished cards and shows them again; the bar counts them ("3 hidden") so nothing looks lost. `a` (or `Tag done (a)`) adds the done tag, `#lm-done` by default, to the end of the selected card's task line: a card that carries it is hidden automatically, in the board and in the Tasks panel, until you press `a` on it again after `A` reveals it. `A` is a session switch (it never touches the config): the next `o` (or `H` in the Tasks panel) ends the reveal and applies what you chose, so the keys can be pressed in any order. Hiding only changes what you see; the only thing ever written to a note is the tag you asked for. All of it is configurable: `hide_completed_kanban` (hide finished cards by default, `false`), `done_tag` (the tag name, `lm-done`) and `done_tag_hides` (where the tag hides: `both`, `kanban`, `tasks` or `none`), plus `hide_completed_tasks` for the Tasks panel. See [docs/configuration.md](docs/configuration.md). With the defaults nothing is hidden until you press a key.
  43. The column is a tag at the end of the task line, so it works in any editor: `- [ ] write report #kb/doing`. Set your own columns (2 to 6) in the config:
  44. ```json
  45. "kanban_columns": [
  46. {"id": "todo", "titles": {"en": "To do", "es": "Por hacer"}},
  47. {"id": "doing", "title": "Writing"},
  48. {"id": "review"},
  49. {"id": "done"}
  50. ]
  51. ```
  52. <img src="assets/readme/feature-kanban.gif" alt="Moving cards between the columns of the Kanban board" width="100%">
  53. ### CLI and MCP
  54. Everything the board does is available without the interface, with a stable `--json` output and exit codes, and over MCP for agents:
  55. ```
  56. $ lazymark task list --pending --json
  57. $ lazymark task move projects/plan.md#16de6420 doing
  58. $ lazymark note new "Meeting" --folder work
  59. $ claude mcp add --transport stdio lazymark -- lazymark mcp
  60. ```
  61. <img src="assets/readme/feature-cli.gif" alt="Listing pending tasks in the terminal, moving one to the doing column and reading it back as JSON" width="100%">
  62. See [docs/cli.md](docs/cli.md) for the commands, the JSON schema, the exit codes and the MCP tools.
  63. ### Links between notes
  64. `[[note]]` and `[[note|alias]]` link notes the way Obsidian does. In the preview they are underlined, `n` and `N` move between them, `Enter` or a click follows one (a link to a note that does not exist offers to create it), and the end of the preview lists the notes that link to this one. Renaming a note offers to update the links that point to it, showing the lines that change. See [docs/links.md](docs/links.md).
  65. <img src="assets/readme/feature-links.gif" alt="Following a wikilink from a note to another and reading the list of notes that link to it" width="100%">
  66. ### Search
  67. `/` searches all the notes as you type and jumps to the match; `lazymark search` and the MCP tool `search_notes` do the same without the interface (see [docs/cli.md](docs/cli.md)).
  68. <img src="assets/readme/feature-search.gif" alt="Searching all the notes while typing and jumping to a match" width="100%">
  69. ### Inline images
  70. Images in a note show up in the preview, in place, in terminals that support the Kitty graphics protocol. `Ctrl+V` pastes the image on your clipboard into the note, and pasting a copied image file imports it.
  71. <img src="assets/readme/feature-images.png" alt="The preview of a note showing an architecture diagram between two paragraphs of text" width="100%">
  72. ### Settings and themes
  73. Press `,`. The interface speaks eight languages (English, Spanish, Brazilian Portuguese, French, German, Italian, Japanese and Simplified Chinese) and starts in yours; `docs/i18n.md` says which translations a native speaker has reviewed. Fourteen themes (Catppuccin ×4, Tokyo Night, Gruvbox, Nord, Dracula, One Dark, Rosé Pine, Kanagawa, Everforest, Solarized Dark and Light), changed live, and the whole interface follows them, including the markdown preview. You can add your own as a JSON file ([how](docs/configuration.md)). **Screen background** is `theme` by default and paints the whole screen with the theme's base color; `terminal` keeps your terminal's background, so a translucent terminal stays translucent. You can also pick the notes folder here.
  74. <img src="assets/readme/feature-settings.gif" alt="Switching to Solarized Light and Dracula live, then turning the screen background from theme to terminal" width="100%">
  75. ### Paste images from your editor
  76. Copy a screenshot, or an image file in the file manager, open the note in micro, vim or GNU nano and press one key: the `![](assets/…)` reference lands at the cursor and the image is saved next to the note. `lazymark editor-plugins install` sets it up; the keys are `Alt-i` in micro, `\ip` in vim and `Alt-7` in nano (on macOS terminals, set Option to act as Alt). The GIF runs micro's `pasteimage` command, which `Alt-i` also runs. The nano that ships with macOS is Pico and has no key bindings: use GNU nano (`brew install nano`). See [docs/editor-plugins.md](docs/editor-plugins.md).
  77. <img src="assets/readme/feature-paste.gif" alt="Opening a note in micro and pasting a copied image as a markdown reference at the cursor" width="100%">
  78. ## Obsidian compatibility
  79. A lazymark notes folder is an Obsidian vault: open the same folder in both and they work on the same files. lazymark never adds a hidden folder or a database, and it does not touch the `.obsidian` folder.
  80. What lazymark reads and writes the way Obsidian does:
  81. - **Wikilinks**: `[[note]]`, `[[note|alias]]`, `[[note#Heading]]`, `[[note#^block]]` and `[[folder/note]]`. Renaming a note or a folder offers to update the links that point to it ([docs/links.md](docs/links.md)).
  82. - **Tags**: inline `#tags`, including Unicode names such as `#café` and nested
  83. ones such as `#project/web` (category `project`). See [docs/tags.md](docs/tags.md)
  84. for boundaries and exclusions.
  85. - **Tasks**: `- [ ]` and `- [x]` lines, nested at any depth.
  86. - **Task dates** of the [Obsidian Tasks](https://publish.obsidian.md/tasks/Introduction) plugin, in both of its formats. It always reads both, mixed in the same vault if you like:
  87. | Task format in Obsidian Tasks | How the dates look in the file | `lazymark dates migrate` |
  88. |---|---|---|
  89. | Dataview | `[start:: 2026-10-05] [due:: 2026-10-09]` | `--to dataview` |
  90. | Tasks (the default of the plugin) | a small emoji icon before each date (a calendar for the due date) | `--to emoji` |
  91. The fields are start, due, completion, scheduled and created. lazymark writes the format you choose in Settings (`,`) → **Date format** (`date_format`): Dataview by default, plain ASCII that looks the same in any editor and on GitHub. A vault that already has emoji dates and none in Dataview keeps writing emojis, and lazymark tells you once how to change it.
  92. **Which one to pick.** In Obsidian open *Settings → Tasks → Task format* and choose the same one in lazymark. Obsidian Tasks reads one format at a time and has no tool to convert a vault, so if the two do not match, Obsidian will not see the dates lazymark writes. To convert the notes you already have:
  93. ```
  94. lazymark dates migrate # no --to: says how many tasks use each format and what to try
  95. lazymark dates migrate --to dataview --dry-run # shows the change, writes nothing
  96. lazymark dates migrate --to dataview # applies it (--to emoji goes back)
  97. ```
  98. It is never automatic, only touches task lines (not paragraphs, code blocks or the front matter), writes each note atomically and a second run changes nothing. Then set the same *Task format* in Obsidian.
  99. What is **not** compatible, so you are not surprised:
  100. - Priorities, recurrence (`every week`), dependencies and `on completion` are not interpreted. They stay in the line, untouched and shown as text; ticking a recurring task does **not** create the next one.
  101. - Tasks and Dataview **query blocks** are not run: they show as the code they are.
  102. - Tags in the front matter (`tags: [x]`) are not read as categories; only inline `#tags` are. The front matter itself is never modified.
  103. - Embeds (`![[file]]`), canvases, callouts, plugins and the graph view are not supported.
  104. ## Install
  105. Install a [Nerd Font](https://www.nerdfonts.com/) in your terminal for the folder and note icons. Building needs Go 1.27.2 or newer.
  106. **With Go**
  107. ```sh
  108. go install github.com/MathiasDrizzy/lazymark/cmd/lazymark@latest
  109. ```
  110. **From source**
  111. ```sh
  112. git clone https://github.com/MathiasDrizzy/lazymark.git
  113. cd lazymark
  114. go build -o lazymark ./cmd/lazymark
  115. ```
  116. **Homebrew (macOS)**
  117. ```sh
  118. brew install mathiasdrizzy/tap/lazymark
  119. ```
  120. **Prebuilt binaries** for macOS, Linux and Windows are on the [Releases page](https://github.com/MathiasDrizzy/lazymark/releases).
  121. ## Quick start
  122. 1. Run `lazymark`. It opens `~/Documents/notes`, creating it if needed. Use `lazymark --dir <folder>` for another folder, or pick one later in Settings.
  123. 2. Press `c`, type a name and press `Enter` to create a note. Press `e` to write in your editor (`$EDITOR`, `micro` if it is not set).
  124. 3. Press `?` any time to see the keys.
  125. ## Keys
  126. The essentials. `?` shows the keys of the panel you are in, and [docs/keybindings.md](docs/keybindings.md) has all of them.
  127. <!-- keys:start -->
  128. | Keys | Action |
  129. |---|---|
  130. | `↑` `↓` | Up / Down |
  131. | `Tab` | Next panel |
  132. | `1` `2` `3` `4` | Jump to a panel |
  133. | `c` `F` | New note / New folder |
  134. | `r` `m` `d` | Rename / Move / Delete |
  135. | `Space` `d` | Toggle a task / Dates (Tasks panel and Kanban) |
  136. | `W` | Kanban board |
  137. | `/` `T` | Search / Daily note |
  138. | `?` `,` `x` | Keybindings / Settings / Trash |
  139. | `q` | Quit |
  140. <!-- keys:end -->
  141. ## Configuration
  142. Most things are in Settings (`,`) and are saved at once. They live in a `config.json` in your user configuration folder (`~/Library/Application Support/lazymark/` on macOS, `~/.config/lazymark/` on Linux, `%AppData%\lazymark\` on Windows). A file with only what you want to change is enough:
  143. ```json
  144. {
  145. "theme": "tokyo-night",
  146. "editor": "code --wait",
  147. "screen_background": "theme",
  148. "popup_background": "none"
  149. }
  150. ```
  151. Almost everything lazymark does its own way can be changed or turned off: the date warnings and colors, the mascot and its `click me!`, the trash days (or no trash), where the daily notes and templates live, the prefix of the board tag, the order of the Notes and Tasks panels and the glyph of each date field. See [docs/configuration.md](docs/configuration.md) for every setting, the command line and the commands for scripts and other tools (`lazymark task list`, `lazymark mcp`, and more). If you write in micro, vim or nano, [docs/editor-plugins.md](docs/editor-plugins.md) shows how to paste a copied image into the note from the editor.
  152. ## Compatibility
  153. | | Status |
  154. |---|---|
  155. | macOS | Developed and tested here, including the interface. |
  156. | Linux | Builds, and its tests run on every change, and its interface tests (a terminal emulator driving the real binary) also run in a Linux container. Not used interactively by the author yet. |
  157. | Windows | Builds, and its tests run on every change. Not used interactively by the author yet; [docs/windows.md](docs/windows.md) has a checklist to try it by hand. |
  158. | Terminal | Inline images |
  159. |---|---|
  160. | Ghostty | ✓ tested |
  161. | Kitty, WezTerm | ✓ support the protocol, not tested |
  162. | Any other | ✗ each image shows as `[image: name.png]` |
  163. Limitations:
  164. - Tasks are the list items that start with `- [ ]` or `- [x]` (also `*`, `+` and numbered), nested at any depth; code blocks are ignored.
  165. - The Kanban board has 2 to 6 columns, in the order of your config; cards can be reordered only among tasks of the same note.
  166. - Pasting an image from the clipboard (`Ctrl+V`, or `lazymark paste` from an editor) needs `osascript` or `pngpaste` (macOS), `wl-paste` or `xclip` (Linux) or PowerShell (Windows).
  167. - The editor plugins need micro, vim or GNU nano; nano also needs the note to be opened from lazymark.
  168. - The terminal must be at least 60 columns by 20 rows.
  169. ## Contributing
  170. Issues and pull requests are welcome. Run `go test ./...` before sending a change, and `git config core.hooksPath scripts/hooks` to run `gofmt`, `go vet` and the tests before every commit. CI runs on Linux, macOS and Windows.
  171. The GIFs are made from the tapes in [assets/readme](assets/readme/CAPTURES.md), so they can be redone with `vhs`.
  172. ## License
  173. [MIT](LICENSE)
  174. ## The mascot
  175. When there is nothing to show in the preview (an empty notes folder, an empty folder or an empty note), a small sloth sleeps at the bottom right of the panel. Click it and it wakes up and plays an animation (it waves, dances, jumps or spins); each click plays the next one. If you leave lazymark alone for about 20 seconds, a faint `click me!` shows above it for 15 seconds, and again every minute while you stay away, just so you find out it can be clicked. It never appears while you are working, and after your first click on the sloth it does not come back during that session. It needs the mouse (not `--no-mouse`) and a terminal at least 60 columns wide. To turn the sloth off, set **Mascot** to off in Settings (`,`) or `mascot = false` in the config.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.