Sauna Built-in Tools

These capabilities are available to all Sauna agents. Do not build bullets for functionality that already exists here. Check this reference before planning new skills.

File Operations

Tool	Purpose
Read	Read files from workspace
Write	Create or replace files
Edit	Single find-replace in a file
MultiEdit	Multiple find-replace operations (atomic)
List (ls)	List directory contents
Glob	Pattern-match files by name
Grep	Search file contents

Code bullets don't need to implement file operations—the agent handles file I/O directly.

Search & Discovery

Tool	Purpose
SemanticSearch	Search connected accounts (Gmail, Notion, Calendar, Drive, Linear)
QueryStructureIndex	SQL queries on indexed markdown (.struct files, frontmatter)

Skills needing to search user data should leverage these built-ins rather than custom search logic.

Shell & Scripts

Tool	Purpose
Bash	Execute shell commands
RunScript	Execute TS/JS/Python with credentials

Code bullets execute via RunScript, which automatically injects credentials. Code receives tokens as PLACEHOLDER_TOKEN—no auth handling needed.

Web & Research

Tool	Purpose
WebSearch	Search the web for current information
WebFetch	Fetch URL content as text/markdown/HTML
DeepResearch	Multi-source research synthesis (slow, thorough)

Critical: Do NOT build web fetching bullets. WebFetch already retrieves URLs and converts HTML to clean markdown. Skills needing web content should instruct the agent to use WebFetch directly.

Task Management

Tool	Purpose
TodoWrite	Create/manage task lists
TodoRead	Read current todos
Task	Launch autonomous subagents

Skills don't need to implement task tracking—the runtime handles it.

Account & Integration

Tool	Purpose
ConnectAccount	Generate OAuth connection URL
ListApps	Browse available integrations (2000+ via Pipedream)

Skills declare required connections via metadata.discovery.connections. The agent uses ConnectAccount to establish them.

What NOT to Build

Built-in Capability	Don't Build
WebFetch	Web content fetching skill
WebSearch	Web search skill
DeepResearch	Research aggregation skill
SemanticSearch	Account data search skill
Bash + Grep	File search utilities
RunScript	Script execution framework

What TO Build

Build bullets for capabilities that don't exist in the runtime:

• API integrations — Code that calls specific service APIs (Gmail, Slack, Notion)
• Data transformation — Processing logic for specific domains
• Workflow orchestration — Tasks combining multiple operations with judgment
• Knowledge — Slices with domain expertise, patterns, best practices
• Specialized parsing — When WebFetch markdown isn't sufficient