# Anote

> Use the anote CLI to create UTF-8 rich-text Apple Notes from Markdown or HTML on macOS. Trigger whenever the user asks to save, store, write, add, or create content in Apple Notes/备忘录, especially Chinese text, multiline text, Markdown, HTML, headings, lists, bold, italic, code blocks, or links. Prefer this over memo/apple-notes for creating notes.

- **Type:** Skill
- **Install:** `agentstack add skill-midboss1028-beep-apple-notes-richtext-skill-anote`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [midboss1028-beep](https://agentstack.voostack.com/s/midboss1028-beep)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [midboss1028-beep](https://github.com/midboss1028-beep)
- **Source:** https://github.com/midboss1028-beep/apple-notes-richtext-skill/tree/main/skills/anote

## Install

```sh
agentstack add skill-midboss1028-beep-apple-notes-richtext-skill-anote
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# anote Apple Notes Writer

Use `anote` when the user wants content saved into Apple Notes/备忘录. This replaces the old `memo`-based Apple Notes creation workflow because it handles UTF-8, Chinese, multiline Markdown, HTML, and richer formatting more reliably.

Open-source project: `apple-notes-richtext-skill`.

## Quick Workflow

1. Prepare the note content as UTF-8 Markdown or HTML.
2. Write the body to a temporary file, usually under `/tmp`, with a safe suffix such as `.md` or `.html`.
3. Run `anote add` with `--title` and `--from`.
4. Report the title and destination after success. Do not echo sensitive note content back unless the user asks.

Markdown example:

```bash
anote add --title "项目备忘" --from /tmp/anote-note.md --format markdown
```

HTML example:

```bash
anote add --title "项目备忘" --from /tmp/anote-note.html --format html
```

Folder example:

```bash
anote add --title "项目备忘" --folder "工作" --from /tmp/anote-note.md
```

Account and folder example:

```bash
anote add --title "项目备忘" --account "iCloud" --folder "Notes" --from /tmp/anote-note.md
```

## Content Handling Rules

- Always use UTF-8 for input files.
- Prefer `--from` with a temp file for generated content.
- `--stdin` is acceptable for short, non-sensitive content:

```bash
printf '%s\n' '# 标题' '' '正文' | anote add --title "标题" --stdin
```

- Do not pass the note body directly into AppleScript or `osascript`.
- Do not use `osascript -e '...正文...'`.
- Do not use `memo` to create rich Markdown notes; use `anote`.
- Avoid `--debug` for sensitive content. It prints temp paths, not the body, but still indicates where files are.
- Use `--dry-run` only when the user wants to inspect HTML or when debugging non-sensitive content. `--dry-run` does not open Notes and does not create a note.

## Supported Formatting

The first version supports:

- headings
- paragraphs and real line breaks
- unordered lists
- ordered lists
- bold
- italic
- inline code
- fenced code blocks
- links

Notes.app decides final rendering, so blockquotes, horizontal rules, tables, and nested formatting may be simplified.

## Error Handling

If `anote` fails:

- Folder missing: tell the user the folder does not exist; do not auto-create folders unless asked.
- Account missing: tell the user the account name was not found.
- Automation permission: tell the user to allow Terminal/Python/OpenClaw to control Notes.app in System Settings > Privacy & Security > Automation.
- Timeout: tell the user Notes.app may be unresponsive or waiting for permission; retry once only if it is safe.

Never delete Apple Notes unless the user explicitly asks and confirms at action time.

## Limits

This skill is for creating new Apple Notes. It does not support native checklist items, images, attachments, search, append, update, or delete. For unsupported operations, explain the limitation and ask how the user wants to proceed.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [midboss1028-beep](https://github.com/midboss1028-beep)
- **Source:** [midboss1028-beep/apple-notes-richtext-skill](https://github.com/midboss1028-beep/apple-notes-richtext-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-midboss1028-beep-apple-notes-richtext-skill-anote
- Seller: https://agentstack.voostack.com/s/midboss1028-beep
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.