TOOLS.md — Local Notes

Skills define HOW tools work. This file is for YOUR specifics — the stuff that's unique to your setup.

What Goes Here

Things like:

• SSH hosts and aliases
• Device nicknames
• Preferred voices for TTS
• Anything environment-specific

Built-in Tools

• shell — Execute terminal commands
  • Use when: running local checks, build/test commands, or diagnostics.
  • Don't use when: a safer dedicated tool exists, or command is destructive without approval.
• file_read — Read file contents
  • Use when: inspecting project files, configs, or logs.
  • Don't use when: you only need a quick string search (prefer targeted search first).
• file_write — Write file contents
  • Use when: applying focused edits, scaffolding files, or updating docs/code.
  • Don't use when: unsure about side effects or when the file should remain user-owned.
• memory_store — Save to memory
  • Use when: preserving durable preferences, decisions, or key context.
  • Don't use when: info is transient, noisy, or sensitive without explicit need.
• memory_recall — Search memory
  • Use when: you need prior decisions, user preferences, or historical context.
  • Don't use when: the answer is already in current files/conversation.
• memory_forget — Delete a memory entry
  • Use when: memory is incorrect, stale, or explicitly requested to be removed.
  • Don't use when: uncertain about impact; verify before deleting.

---

Add whatever helps you do your job. This is your cheat sheet.