Skip to content
Back to search

ironleaf

Free, open-source notes app: plain Markdown on your PC with Today, projects, people, meetings, a graph and an MCP server for any AI.

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 21 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/ironleaf-app/ironleaf 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/ironleaf-app/ironleaf'

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/ironleaf-app--ironleaf/badge.svg)](/listings/ironleaf-app--ironleaf)

HTML

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

Install

i

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 · 162 lines
  1. <h1 align="center">Ironleaf</h1>
  2. <p align="center"><b>Your work, your notes, your AI: plain Markdown files on your own computer, organised for you.</b></p>
  3. <p align="center">
  4. <a href="https://github.com/ironleaf-app/ironleaf/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/ironleaf-app/ironleaf/actions/workflows/ci.yml/badge.svg?branch=main"></a>
  5. <a href="LICENSE"><img alt="Licence: AGPL-3.0-or-later" src="https://img.shields.io/badge/licence-AGPL--3.0--or--later-blue"></a>
  6. <a href="https://github.com/ironleaf-app/ironleaf/releases/latest"><img alt="Latest release" src="https://img.shields.io/github/v/release/ironleaf-app/ironleaf?label=release"></a>
  7. <img alt="Windows and Linux" src="https://img.shields.io/badge/platforms-Windows%20%7C%20Linux-lightgrey">
  8. </p>
  9. <p align="center">
  10. <a href="https://ironleaf.kaitiaki-it.com/download/"><b>Download Ironleaf</b></a> ·
  11. <a href="docs/MCP.md">Connect an AI</a> ·
  12. <a href="#build-from-source">Build from source</a> ·
  13. <a href="#how-ironleaf-is-funded">How it is funded</a>
  14. </p>
  15. ![Today in Ironleaf: late and next tasks on the left, today's meetings and what needs you on the right](docs/images/today.png)
  16. Ironleaf is a free, open-source notes app for Windows and Linux. Your notes are ordinary Markdown files in a folder
  17. you choose: no lock-in, no account needed, readable by any text editor. On top of those files Ironleaf keeps your
  18. day, your projects, the people you work with and your meetings in order, and lets the AI you already use work with
  19. them, on your terms.
  20. ## What you get
  21. - **Today**: what is late, what is next, today's meetings and what needs you, in one view.
  22. - **Projects**: status, health, next steps, waiting-on-others, decisions and risks, gathered from your notes.
  23. - **People**: everyone you work with, their meetings, the actions they owe you and the ones you owe them.
  24. - **Meetings with minutes**: record a meeting, get a transcript with speakers, then minutes with decisions and
  25. actions that land on the right projects and people. Telling the speakers apart runs on your PC.
  26. - **Graph and canvas**: see how notes, projects and people connect; lay ideas out on boards saved as JSON Canvas.
  27. - **AI built in, on your own key or a local model**: a side chat beside every note, Ask (a question in the Ctrl+K
  28. box, answered from your notes with its sources) and meeting minutes, on Anthropic, OpenAI, Gemini, Ollama or any OpenAI-compatible
  29. endpoint. No Ironleaf middleman, and private notes never reach a model.
  30. - **MCP server with 80 tools**: Claude Desktop, Claude Code, ChatGPT desktop, Cursor, VS Code and other MCP apps can
  31. search, read and (only if you allow it) change your notes. Every change is listed with Undo.
  32. - **Search by meaning and OCR**, on-device and offline; a quick switcher (Ctrl+O) and every command (Ctrl+K) from
  33. the keyboard.
  34. - **Lives in the tray**: reminders, backups, sync and AI access carry on when the window is closed.
  35. - **Signed self-updates**: an update installs only if it is signed with Kaitiaki IT's release key.
  36. - **Plain Markdown files**: links, embeds, tags, properties, callouts and canvases that keep working in other
  37. Markdown notes apps.
  38. - **Optional, paid: Ironleaf Sync and Teams**: end-to-end encrypted sync across your PCs, and shared team vaults.
  39. They fund development; everything else is free.
  40. <table>
  41. <tr>
  42. <td width="50%"><img alt="A meeting with its minutes, decisions, actions and transcript" src="docs/images/meeting-minutes.png"></td>
  43. <td width="50%"><img alt="Projects: a list with health and due dates, the selected project's actions, meetings and people" src="docs/images/projects.png"></td>
  44. </tr>
  45. <tr>
  46. <td align="center">Meetings: minutes, decisions and actions from the transcript</td>
  47. <td align="center">Projects: health, actions, people and decisions in one place</td>
  48. </tr>
  49. <tr>
  50. <td colspan="2"><img alt="The graph: notes grouped by area, one meeting's connections highlighted" src="docs/images/graph.jpg"></td>
  51. </tr>
  52. <tr>
  53. <td colspan="2" align="center">The graph: how your notes, projects, people and meetings connect</td>
  54. </tr>
  55. </table>
  56. <sub>Screenshots use a made-up sample vault; every name and company in them is fictional.</sub>
  57. ## Download
  58. Installers for Windows (setup .exe) and Linux (AppImage) are at
  59. **[ironleaf.kaitiaki-it.com/download](https://ironleaf.kaitiaki-it.com/download/)** and on the
  60. [GitHub releases page](https://github.com/ironleaf-app/ironleaf/releases). Installed copies update themselves.
  61. ## Build from source
  62. Needs Node.js 22 or later and git. On Linux the app needs the usual Electron libraries; the UI walks need `xvfb-run`.
  63. ```bash
  64. git clone https://github.com/ironleaf-app/ironleaf.git
  65. cd ironleaf
  66. npm ci # also applies the small patch in tools/pi-ai-patches (postinstall)
  67. npm run dev # the app, with hot reload
  68. npm run typecheck
  69. npm run build # main, preload and window into out/
  70. npm start # the built app
  71. ```
  72. Installers (AppImage, Windows NSIS) are made by `tools/release.mjs`; see [docs/RELEASING.md](docs/RELEASING.md).
  73. Official builds are signed by Kaitiaki IT; a build you make yourself only updates from where you point it.
  74. ## Run the tests
  75. ```bash
  76. npm run test:fast # the unit checks that need no window: what CI runs on Linux and Windows
  77. npm test # everything, including the UI walks that start the built app (Linux: under xvfb-run)
  78. ```
  79. ## Connect an AI over MCP
  80. Settings › Connect an AI switches the MCP server on (off by default; Read only until you choose Read and write).
  81. Two ways in: the `ironleaf mcp` command (stdio) for apps that start a server, or the local URL
  82. (`http://127.0.0.1:47731/mcp` with a token) for apps that take an address. Set-up for Claude Desktop, Claude Code,
  83. Cursor, VS Code and ChatGPT desktop, and the list of all 80 tools, are in **[docs/MCP.md](docs/MCP.md)**. Private
  84. notes and secrets are never served, and nothing leaves your machine unless the AI app you connect sends it.
  85. ## How Ironleaf is funded
  86. Ironleaf is made by Kaitiaki IT Pty Ltd (Melbourne, Australia). The app is free and open source, and everything one
  87. person needs on their own computer stays free. Development is paid for by:
  88. - **Supporter**: an optional one-off purchase that says thank you and shows a Supporter mark in the app.
  89. - **Ironleaf Sync**: end-to-end encrypted sync of your notes across your PCs (the server never sees names or contents).
  90. - **Ironleaf Teams**: shared team vaults, members and roles, and a team policy applied on every member's PC.
  91. - **Enterprise licence**: a commercial licence (no AGPL obligations), managed deployment, governance and support for
  92. organisations. See [docs/EDITIONS.md](docs/EDITIONS.md).
  93. Signing in is optional and only needed for these; your notes never need an account.
  94. ## How it is put together
  95. ```
  96. src/
  97. main/ the window, the notes folder (vault.ts: every path kept inside it; atomic writes; watching), the index
  98. (links, backlinks, graph, search, retrieval), file recovery, settings, AI providers, the local MCP
  99. server, the tray, signed updates, the optional account, Sync and Teams clients
  100. preload/ the only calls the window can make
  101. renderer/ the window: workspace (tabs, splits, sidebars), the editor (CodeMirror 6 with Live Preview), pages
  102. (Today, Projects, People, Meetings, Tasks), canvas, graph, settings
  103. shared/ types, preferences, Markdown helpers, search, properties and dates used by both sides
  104. ```
  105. Security: the window runs sandboxed with context isolation and no Node; every request is checked to come from
  106. Ironleaf's own window; paths cannot leave the notes folder (symlinks included); deleting goes to the Recycle Bin; raw
  107. HTML in notes and answers is never run; the packaged window has a strict Content Security Policy; web links open in
  108. the browser.
  109. Ironleaf is not affiliated with or endorsed by the makers of other notes apps.
  110. ## Licence and trademarks
  111. The code is licensed under **AGPL-3.0-or-later** ([LICENSE](LICENSE)); bundled third-party software keeps its own
  112. licences ([THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md), [ASSETS.md](ASSETS.md)). If you run a modified Ironleaf
  113. for others over a network, the AGPL asks you to offer them its source. Organisations that cannot accept the AGPL can
  114. get a commercial licence ([docs/EDITIONS.md](docs/EDITIONS.md)).
  115. "Ironleaf" and the leaf logo are trademarks of Kaitiaki IT Pty Ltd. The licence covers the code, not the name or
  116. logo: a fork you distribute must use another name and icon. See [TRADEMARKS.md](TRADEMARKS.md).
  117. ## Contributing
  118. Contributions are welcome: see [CONTRIBUTING.md](CONTRIBUTING.md). Contributors sign the
  119. [Contributor Licence Agreement](CLA.md) once, on their first pull request (a bot asks). Please follow the
  120. [Code of Conduct](CODE_OF_CONDUCT.md).
  121. **Built with AI assistance.** Kaitiaki IT builds Ironleaf with AI coding assistants, under human review: every change
  122. is read, tested and merged by a maintainer, and the same checks (typecheck, build and the test suite in CI) apply to
  123. all code, whoever or whatever wrote it.
  124. ## Security
  125. Please report vulnerabilities privately to **security@kaitiaki-it.com** or through
  126. [GitHub private vulnerability reporting](https://github.com/ironleaf-app/ironleaf/security/advisories/new),
  127. never in a public issue. See [SECURITY.md](SECURITY.md).

Ratings and comments

Sign in to rate this skill.

Sign in

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