Apple Notes CLI

CLI tool for creating notes in Apple Notes.

Requirements

- macOS
- Node.js ≥ 14.0.0

Installation

$3

``bash
npm install -g apple-notes-cli@latest
`

$3

`bash

Clones the repository and automatically creates a "notes" folder

git clone https://github.com/marcusvoelkel/notes.git
cd notes
npm install
npm link
`

$3

The post-install script automatically configures:
- Shell aliases (note, n) in .zshrc/.bashrc
- Claude Code Slash Command (/note)
- Codex CLI Integration (if installed)

Manual setup if needed:
`bash
npm run setup
`

$3


`bash

Check for updates

notes-cli --update

Update via npm (when published)

npm update -g apple-notes-cli

Update via git

cd ~/notes && git pull && npm install
`

Usage

$3

After installation, the following shortcuts are configured:
- note - Alias for notes-cli
- n - Short alias for notes-cli

`bash


With alias

note "My note"
n "Quick note"

Natural language in Claude, Code, Codex CLI etc.

"Summarize this chat in an Apple Note..."
"Create an Apple Note about..."
"Write an article about and save it in Apple Notes"

Simple note

notes-cli "Title"
note "Title"
n "Title"

Note with content

notes-cli "Title" "Note content"
note "Title" "Note content"
n "Title" "Note content"

Multi-line with Markdown

notes-cli "Meeting" "## Agenda\n- Point 1\n- Point 2"

Show version

notes-cli --version

Check for updates

notes-cli --update

Show help

notes-cli --help
`

Markdown Support

- # Heading - Headings
- bold and italic
- - List - Bullet points
- code - Inline code

Debug

`bash
DEBUG=true notes-cli "Test" "Debug content"
`

License

MIT

---

Deutsch / German

CLI-Tool zum Erstellen von Notizen in Apple Notes.

$3

- macOS
- Node.js ≥ 14.0.0

$3

#### Via npm (empfohlen)
`bash
npm install -g apple-notes-cli@latest
`

#### Via GitHub
`bash


Klont das Repository und erstellt automatisch einen "notes" Ordner


git clone https://github.com/marcusvoelkel/notes.git
cd notes
npm install
npm link
`

#### Setup Integration (Automatisch beim Install)
Das Post-Install Script konfiguriert automatisch:
- Shell-Aliases (note, n) in .zshrc/.bashrc
- Claude Code Slash Command (/note)
- Codex CLI Integration (falls installiert)

Manuelles Setup falls benötigt:
`bash
npm run setup
`

#### Update
`bash


Check for updates

notes-cli --update

Update via npm (when published)

npm update -g apple-notes-cli

Update via git

cd ~/notes && git pull && npm install
`

$3

#### Shortcuts/Aliases
Nach der Installation wurden folgende Shortcuts eingerichtet:
- note - Alias für notes-cli
- n - Kurz-Alias für notes-cli

`bash


Mit Alias

note "Meine Notiz"
n "Schnelle Notiz"

Natürliche Sprache nutzen in Claude, Code, Codex CLI o.ä.

"Fasse mir den Chat in einer Apple-Note zusammen..."
"Erstelle eine Apple-Note zu..."
'Schreibe einen Artikel über und speichere ihn in Apple Notes"

Simple note

notes-cli "Title"
note "Title"
n "Title"

Note with content

notes-cli "Title" "Note content"
note "Title" "Note content"
n "Title" "Note content"

Multi-line with Markdown

notes-cli "Meeting" "## Agenda\n- Point 1\n- Point 2"

Show version

notes-cli --version

Check for updates

notes-cli --update

Show help

notes-cli --help
`

$3

- # Heading - Überschriften
- fett und kursiv
- - Liste - Bullet Points
- code - Inline Code

$3

`bash
DEBUG=true notes-cli "Test" "Debug-Inhalt"
``

$3

MIT