Back to Zeroclaw

TOOLS.md — Local Notes

crates/zeroclaw-runtime/src/agent/personality_templates/TOOLS.md

0.7.51.5 KB
Original Source

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.