mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-04-28 01:21:43 +00:00
f210510276
Skills can now declare runtime prerequisites (env vars, CLI binaries) via YAML frontmatter. Skills with unmet prerequisites are excluded from the system prompt so the agent never claims capabilities it can't deliver, and skill_view() warns the agent about what's missing. Three layers of defense: - build_skills_system_prompt() filters out unavailable skills - _find_all_skills() flags unmet prerequisites in metadata - skill_view() returns prerequisites_warning with actionable details Tagged 12 bundled skills that have hard runtime dependencies: gif-search (TENOR_API_KEY), notion (NOTION_API_KEY), himalaya, imessage, apple-notes, apple-reminders, openhue, duckduckgo-search, codebase-inspection, blogwatcher, songsee, mcporter. Closes #658 Fixes #630
90 lines
2.1 KiB
Markdown
90 lines
2.1 KiB
Markdown
---
|
|
name: apple-notes
|
|
description: Manage Apple Notes via the memo CLI on macOS (create, view, search, edit).
|
|
version: 1.0.0
|
|
author: Hermes Agent
|
|
license: MIT
|
|
platforms: [macos]
|
|
metadata:
|
|
hermes:
|
|
tags: [Notes, Apple, macOS, note-taking]
|
|
related_skills: [obsidian]
|
|
prerequisites:
|
|
commands: [memo]
|
|
---
|
|
|
|
# Apple Notes
|
|
|
|
Use `memo` to manage Apple Notes directly from the terminal. Notes sync across all Apple devices via iCloud.
|
|
|
|
## Prerequisites
|
|
|
|
- **macOS** with Notes.app
|
|
- Install: `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
|
|
- Grant Automation access to Notes.app when prompted (System Settings → Privacy → Automation)
|
|
|
|
## When to Use
|
|
|
|
- User asks to create, view, or search Apple Notes
|
|
- Saving information to Notes.app for cross-device access
|
|
- Organizing notes into folders
|
|
- Exporting notes to Markdown/HTML
|
|
|
|
## When NOT to Use
|
|
|
|
- Obsidian vault management → use the `obsidian` skill
|
|
- Bear Notes → separate app (not supported here)
|
|
- Quick agent-only notes → use the `memory` tool instead
|
|
|
|
## Quick Reference
|
|
|
|
### View Notes
|
|
|
|
```bash
|
|
memo notes # List all notes
|
|
memo notes -f "Folder Name" # Filter by folder
|
|
memo notes -s "query" # Search notes (fuzzy)
|
|
```
|
|
|
|
### Create Notes
|
|
|
|
```bash
|
|
memo notes -a # Interactive editor
|
|
memo notes -a "Note Title" # Quick add with title
|
|
```
|
|
|
|
### Edit Notes
|
|
|
|
```bash
|
|
memo notes -e # Interactive selection to edit
|
|
```
|
|
|
|
### Delete Notes
|
|
|
|
```bash
|
|
memo notes -d # Interactive selection to delete
|
|
```
|
|
|
|
### Move Notes
|
|
|
|
```bash
|
|
memo notes -m # Move note to folder (interactive)
|
|
```
|
|
|
|
### Export Notes
|
|
|
|
```bash
|
|
memo notes -ex # Export to HTML/Markdown
|
|
```
|
|
|
|
## Limitations
|
|
|
|
- Cannot edit notes containing images or attachments
|
|
- Interactive prompts require terminal access (use pty=true if needed)
|
|
- macOS only — requires Apple Notes.app
|
|
|
|
## Rules
|
|
|
|
1. Prefer Apple Notes when user wants cross-device sync (iPhone/iPad/Mac)
|
|
2. Use the `memory` tool for agent-internal notes that don't need to sync
|
|
3. Use the `obsidian` skill for Markdown-native knowledge management
|