Shared batch CRUD
Goals, projects, tasks, habits, notes, Psyche records, preferences, questionnaires, sleep sessions, workout sessions, and most stored records use search, create, update, delete, and restore batch tools.
Agent Tools
Every Forge tool exposed to agents.
This page lists the core Forge agent tools used by OpenClaw, Hermes, Codex, and Claude Code. The descriptions come from the same onboarding catalog agents read before they act. Use this page to check what an agent can read or write, when to use each tool, and which inputs matter.
Normal stored entities use the shared batch tools. Movement, Life Force, Workbench, wiki, Artifact Store, calendar helpers, and health read models use their dedicated tool or route family.
- tools
- groups
- visible
Access Rules
The tools are grouped by the API path an agent should use.
Dedicated domain tools
Movement, Life Force, Workbench, wiki, Artifact Store, calendar helpers, nutrition, and training read models use dedicated tools because those surfaces have richer route contracts than generic CRUD.
Human-only file downloads
Artifact tools let agents list, upload when trusted, update metadata, replace generic entity links, rescan, enrich, and read audit or version history. They do not expose artifact download, open, execute, preview, or transform actions.
Read before writing
Agents should read the relevant overview or search endpoint before mutating. That prevents duplicate records, wrong owners, missing ids, and weak context.