Built-In Tools
Athena interacts with your machine through a set of built-in tools. These are called automatically during conversations — you don’t invoke them directly.
File Operations
| Tool | What It Does |
|---|---|
| file_read | Read file contents |
| file_write | Create or overwrite a file |
| file_edit | Edit a file using search and replace |
| directory_list | List directory contents |
File reads and directory listings are always auto-approved. Writes and edits go through your permission rules — small edits can be auto-approved based on your line threshold.
Search
| Tool | What It Does |
|---|---|
| files_grep | Search file contents with regex (uses ripgrep if installed) |
| files_find | Find files by glob pattern |
Both tools respect .gitignore and skip common directories like node_modules, .git, and venv.
Shell
| Tool | What It Does |
|---|---|
| shell_run | Execute a shell command |
| shell_output | Get output from a background command |
| shell_kill | Kill a background command |
| shells_list | List running background commands |
Shell commands are permission-checked against your rules. Commands can run in the foreground (blocking) or background, with configurable timeouts up to 5 minutes. Output is streamed to the chat as it executes.
Knowledge
| Tool | What It Does |
|---|---|
| cogz_fetch | Search your org’s knowledge base for relevant context |
| cogz_write | Save knowledge (decisions, rules, patterns, errors) for future sessions |
See Managing Knowledge for details on what Athena stores and how to search it.
Delegation
| Tool | What It Does |
|---|---|
| delegate | Hand off a sub-task to a faster model |
Athena can delegate focused tasks (file edits, searches, targeted fixes) to a smaller, faster model. The delegate has access to file, search, shell, and knowledge tools — but its permissions bubble up through the same rules.
Bias
| Tool | What It Does |
|---|---|
| bias_set | Shift Athena’s reasoning perspective |
Available perspectives: developer, product, tester, operator, reviewer, project manager. Useful when you want Athena to think about a problem from a specific angle.
MCP Tools
Any tools from connected MCP servers appear alongside the built-in tools. They’re named {server}__{tool} (e.g., github__search_repositories) and work the same way — Athena discovers and calls them automatically.