{
  "markdown": "# HotMarks\n\n**Give your prompts weight.** Semantic formatting plugin for Claude Code.\n\n![HotMarks — semantic formatting plugin for Claude Code by Tawaar Technologies](https://raw.githubusercontent.com/AdhamHossamm/HotMarks-forClaudeCode/master/blob/HotMarks.png)\n\n---\n\n## What is HotMarks?\n\nWhen you talk to Claude Code, every word in your prompt is treated equally. A casual remark and a critical rule carry the same weight. HotMarks changes that.\n\nWith HotMarks, you can mark specific parts of your prompt as:\n\n| What you type | What it means | What Claude does |\n|---------------|---------------|------------------|\n| `**do not delete the database**` | **Directive** — a hard rule | Claude treats this as non-negotiable. No exceptions. |\n| `__make sure tests pass__` | **Critical** — top priority | Claude prioritizes this above everything else. |\n\nEverything else in your prompt stays normal priority.\n\n### Example\n\nYou type this in Claude Code:\n\n```\nRefactor the auth module **do not change the public API** and __ensure all tests pass__\n```\n\nHotMarks automatically tells Claude:\n- \"do not change the public API\" is a **hard rule** — follow it exactly\n- \"ensure all tests pass\" is **critically important** — prioritize it\n\nNo extra steps. No setup menus. Just type your markers and submit.\n\n---\n\n## Install\n\n### Step 1: Add the plugin\n\nOpen Claude Code and run:\n\n```bash\nclaude plugin add hotmarks\n```\n\n### Step 2: Create your config (optional)\n\n```bash\nnpx hotmarks setup\n```\n\nThis creates a `.hotmarks` file in your project folder. You can skip this — HotMarks works with sensible defaults out of the box.\n\n**That's it.** HotMarks is now active on every prompt you submit.\n\n---\n\n## How to Use\n\n### Marking a directive (hard rule)\n\nWrap text in double asterisks — `**like this**`:\n\n```\nBuild the payment API **never log credit card numbers**\n```\n\nClaude will treat \"never log credit card numbers\" as an absolute constraint it cannot violate.\n\n### Marking critical emphasis (top priority)\n\nWrap text in double underscores — `__like this__`:\n\n```\nFix the login bug __this is blocking production__\n```\n\nClaude will treat \"this is blocking production\" as the highest-priority concern.\n\n### Using both together\n\n```\nMigrate the database **do not drop any tables** and __zero downtime required__\n```\n\nClaude knows:\n- \"do not drop any tables\" → hard rule, must obey\n- \"zero downtime required\" → most important concern\n\n### What about code blocks?\n\nHotMarks is smart — it ignores markers inside code blocks. So this:\n\n````\nShow me how to use `**bold**` in markdown\n````\n\nwon't trigger a directive. Only markers in your regular prompt text are detected.\n\n---\n\n## Configuration\n\nHotMarks works without any configuration. If you want to customize behavior, edit the `.hotmarks` file in your project root:\n\n```json\n{\n  \"mode\": \"reminder\",\n  \"skipCodeBlocks\": true\n}\n```\n\n### Modes\n\n| Mode | What it does |\n|------|-------------|\n| `reminder` | Adds context explaining your markers to Claude (default) |\n| `transform` | Replaces markers with explicit tags like `[DIRECTIVE: ...]` |\n| `both` | Does both |\n\n### Where HotMarks looks for config\n\n1. `.hotmarks` in your current project folder\n2. `.hotmarks` in your home directory (`~/.hotmarks`)\n3. Built-in defaults (if no file found)\n\n---\n\n## Update\n\nTo update HotMarks to the latest version:\n\n```bash\nclaude plugin remove hotmarks\nclaude plugin add hotmarks\n```\n\n---\n\n## Uninstall\n\n### Remove the plugin\n\n```bash\nclaude plugin remove hotmarks\n```\n\n### Remove the config file (optional)\n\n```bash\nnpx hotmarks uninstall\n```\n\nOr just delete the `.hotmarks` file from your project folder manually.\n\n---\n\n## How It Works (Technical)\n\n1. You type `**text**` or `__text__` in your prompt\n2. On submit, the `UserPromptSubmit` hook fires\n3. HotMarks parses your prompt for markers (skipping code blocks)\n4. Based on your config mode, it injects semantic context via `additionalContext`\n5. Claude receives structured priority information alongside your prompt\n\nThe plugin runs entirely locally. No data is sent anywhere. No network requests.\n\n---\n\n## Development\n\n```bash\nnpm install       # install dependencies\nnpm run build     # compile TypeScript\nnpm test          # run all 31 tests\n```\n\n### Run locally\n\n```bash\nclaude --plugin-dir .\n```\n\n---\n\n## Requirements\n\n- Node.js 18 or newer\n- Claude Code CLI\n- Zero runtime dependencies\n\n---\n\n## Star History\n\n<a href=\"https://www.star-history.com/?repos=AdhamHossamm%2FHotMarks-forClaudeCode&type=date&legend=top-left\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/chart?repos=AdhamHossamm/HotMarks-forClaudeCode&type=date&theme=dark&legend=top-left\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/chart?repos=AdhamHossamm/HotMarks-forClaudeCode&type=date&legend=top-left\" />\n   <img alt=\"Star History Chart\" src=\"https://api.star-history.com/chart?repos=AdhamHossamm/HotMarks-forClaudeCode&type=date&legend=top-left\" />\n </picture>\n</a>\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## Security\n\nSee [SECURITY.md](SECURITY.md) for reporting vulnerabilities.\n\n## License\n\n[MIT](LICENSE) — see [DISCLAIMER.md](DISCLAIMER.md) for full terms of use.\n\n---\n\n**Built by [Tawaar Technologies](https://github.com/TawaarTech) with Claude Code**\n",
  "bytes": 5345,
  "sha": "d513b7f816b82a9b5d31346dd22609a8c93460c08a19b345c594e4b0ac4e1f62",
  "repo_slug": "adhamhossamm/hotmarks-forclaudecode",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_adhamhossamm_hotmarks_forclaudecode_hotm_8fc7cba8/readme"
}