Imark plugin
A Claude Code plugin sends a plan or document to the Imark macOS app for review and returns the notes via the file.
- 118 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The plugin appends notes to your markdown files and reads the `~/.imark/pending` folder.
- The optional ExitPlanMode hook, once enabled, blocks execution until a person answers in the app.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/imarkDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The plugin appends notes to your markdown files and reads the `~/.imark/pending` folder.
- The optional ExitPlanMode hook, once enabled, blocks execution until a person answers in the app.
This is third-party code. Review the repository files before installing.
What it does
The plugin adds two commands to Claude Code: `/imark:imark-review` opens a markdown file in the Imark app and waits for a decision, and `/imark:imark-notes` hands the agent the open notes. The reader selects a phrase and writes a comment, and the note is saved in the file itself as an HTML comment. Two buttons at the top of the window approve the document or send it back for revision. The bundle includes the imark-comments skill, which teaches the agent to read `<!-- imark … -->` blocks and mark finished notes with `resolved=`. An optional ExitPlanMode hook opens plan-mode plans for review and does nothing until `IMARK_PLAN_REVIEW` is set. There is no server, port or browser: the file is the bridge.
Who it is for. Claude Code users on a Mac who find long agent plans and specs hard to read in the terminal.
Good fit when
- The agent drafted a plan or RFC and it reads better rendered with comments.
- Notes on paragraphs must reach the agent without copying them into chat.
- Accepting a plan before edits needs explicit consent, given with a button.
- Notes about a document should stay in the file and travel with it into a commit.
Not a fit when
- You need to review code or a diff: the author points to GitHub or an editor for that.
- You work on Windows or Linux: the app is macOS only.
- The document is not markdown.
Example request
Open PLAN.md for review in Imark, wait for my decision and apply my notes in the next version of the plan.Limitations
The plugin does not work without the Imark app in `/Applications`, and it needs macOS 14 or newer and Node 20. The plugin script runs `imark` when the command is on the PATH. It is installed through the menu item Install the imark Command. Review is meant for markdown: plans, specs, RFCs. The ExitPlanMode hook is off by default and fires only with the environment variable set. The app contacts GitHub once a day for an update feed, and automatic checks can be turned off in settings. The plugin targets Claude Code, and Codex gets only the skill.
How to disable. Remove the plugin with `/plugin uninstall imark@imark` and unset `IMARK_PLAN_REVIEW`. The app and files in `~/.imark` are removed separately.
FAQ
How do I install Imark in Claude Code?
Run `/plugin marketplace add migsilva89/imark`, then `/plugin install imark@imark`. The Imark app must sit in `/Applications`.
What does the agent see after a review?
`/imark:imark-notes` returns only open notes. Closed ones carry `resolved=` and stay in the file as history, and `--all` shows them too.
What do the Approve and Send Back buttons do?
Approve lets the agent continue with your notes, and Send Back hands it every note for revision.
How do I enable automatic plan review?
Set `IMARK_PLAN_REVIEW`: the ExitPlanMode hook then opens the plan in Imark before execution.
Do documents go over the network?
No. Review runs through the file and the `~/.imark/pending` folder, and the network is used only for update checks.
Discussion
No questions or reviews yet.
Related
PluginsPlugin that intercepts the agent plan and opens it in a browser: strike, replace, insert or comment, then send the feedback back.
A Claude Code plugin that catches your corrections in chat and, after review, writes them into CLAUDE.md and AGENTS.md
Miro's official plugins, skills and MCP: the agent reads boards, draws diagrams, keeps tables and codes from designs
Terminal notes, tasks and a Kanban board over plain markdown files, with a JSON CLI and an MCP server for agents.
Meeting notes on Mac and an MCP for agents: Markdown transcripts, search, recaps and action items, with no bot joining the call
Claude Mods (zycck)
claude-mods (zycck)
A plan-progress plugin for Claude Code that draws progress bars above the prompt with stages, steps and a row for each subagent.
README in short
Imark itself is a macOS markdown reader with live reload, an outline and Quick Look. The plugin adapts it to reviewing agent output.