Tools
The capabilities Saga uses to help you manage your files and data.
How Tools Work
Saga has a set of tools it can use to interact with your files. When you ask Saga to do something—like read a file, search your notes, or update a document—it uses these tools behind the scenes.
You'll see indicators showing which tools Saga is using, so you always know exactly what's happening with your data.
Available Tools
View
Read and display file contents with line numbers. Saga reads files before editing to understand the current content and structure.
Edit
Modify existing files by finding and replacing specific text. Used for fixing typos, updating content, and changing configurations.
Create
Create new files in your vault for notes, documentation, or project files.
Search
Search for content within files using text or patterns. Finds where something is mentioned across your notes.
Find
Find files matching a name pattern (e.g., all .md files). Useful for exploring project structure by file type.
List
List contents of a directory with details. Shows what files exist and helps understand vault structure.
Move
Move or rename files and directories safely. Used for reorganizing files and archiving old content.
Remove
Safely delete files or directories. Saga reads files before removing and asks for confirmation on non-empty directories.
Time
Get the current date and time with your timezone. Used for timestamped entries and scheduling.
SQLBeta
Query and manage a local SQLite database for structured data like habit tracking, personal metrics, and anything that benefits from relational data.
Why This Matters
Unlike cloud-based AI tools, Saga shows you exactly what it's doing. You can see when it reads your files, when it writes new content, and what files it's accessing.
This transparency is part of Saga's commitment to privacy and trust. All tools operate locally on your device—nothing is sent to the cloud.