stella tools
List every tool available to the agent this session.
List every tool available to the agent for the current session — built-in tools, developer custom tools, and manifest diagnostics.
Synopsis
stella tools [--validate [DIR]] [global flags]What it does
stella tools prints the set of tools the agent can call this session:
- Built-in tools — the always-available and conditionally-registered tools. See the full Built-in Tools catalog for names and read-only/mutating flags.
- Developer custom tools — loaded from
<name>.tomlmanifests.
Custom tools come from a <name>.toml manifest dropped in <workspace>/.stella/tools/ (workspace-scoped) or ~/.config/stella/tools/ (user-global). On a name collision, the workspace copy wins.
stella tools does not enumerate MCP tools — it prints a note that servers configured in .stella/mcp.toml merge more tools at session start. Use stella mcp list to see configured MCP servers.
Flags
| Flag | Meaning |
|---|---|
--validate [DIR] | Strict pre-flight check of custom-tool manifests instead of listing. Parses every <name>.toml in .stella/tools/ and ~/.config/stella/tools/ (or the given DIR), reports errors, warnings, and info per manifest, and exits non-zero if any manifest has errors. |
stella tools otherwise takes the global flags; model selection rarely matters for this diagnostic command.
Examples
List the tools available this session:
stella toolsValidate custom-tool manifests in CI (non-zero exit on any error):
stella tools --validate