File Operations
| Tool | Description |
|---|---|
ReadFiles | Read one or more files. Suggests FindSymbol for files >300 lines |
WriteFile | Write content to a file |
EditFile | Targeted exact string replacements in a file (single or batch) |
Grep | Search file contents with regex (ripgrep backend) |
Glob | Match files using glob patterns, sorted by modification time |
FindSymbol | Search code symbols by name, kind, and export status |
Execution
| Tool | Description |
|---|---|
Bash | Execute shell commands. Supports background: true for long-running processes and wait_pid to wait for completion |
Search & Web
| Tool | Description |
|---|---|
WebFetch | Fetch and parse a URL (HTML-to-text conversion) |
Explore | Autonomous sub-agent for filesystem/codebase exploration |
Tasks
| Tool | Description |
|---|---|
TaskAdd | Add tasks to the session task list (auto-incrementing IDs) |
TaskList | List current tasks with optional filtering |
TaskUpdate | Batch update task status or title |
Agent & Planning
| Tool | Description |
|---|---|
LoadSkill | Load a skill from .lukan/skills/ with YAML frontmatter |
PlannerQuestion | Ask clarifying questions with structured options in planner mode |
SubmitPlan | Submit a structured implementation plan with ordered tasks |
SubAgent | Spawn a sub-agent for parallel work |
SubAgentResult | Check or wait for sub-agent completion |
Browser (with --browser flag)
| Tool | Description |
|---|---|
BrowserNavigate | Navigate to a URL |
BrowserNewTab | Open a new tab |
BrowserSnapshot | Take an accessibility tree snapshot (compact mode available) |
BrowserScreenshot | Take a JPEG screenshot of the current page |
BrowserClick | Click an element by reference number |
BrowserType | Type text into an input field |
BrowserEvaluate | Evaluate JavaScript (with security blocklist) |
BrowserSavePDF | Save the current page as a PDF file |
BrowserTabs | List open tabs |
BrowserSwitchTab | Switch between tabs |
Plugin Tools
Plugins can register additional tools via atools.json manifest. These tools are executed through the plugin’s handler script (e.g., tools.js with Node.js).
Plugin-provided tools include:
Email (via plugin)
| Tool | Description |
|---|---|
EmailList | List emails (folder, unseen filter, limit) |
EmailRead | Read email by UID |
EmailReply | Reply to an email with threading headers |
EmailSend | Send a new email |
EmailFolders | List available email folders |
EmailConfirm | Confirm a pending email send |
EmailCancel | Cancel a pending email |
Reminders (via plugin)
| Tool | Description |
|---|---|
ReminderAdd | Add a reminder |
ReminderList | List reminders |
ReminderDone | Mark a reminder as done |
Google Workspace (via plugin)
| Tool | Description |
|---|---|
SheetsRead | Read spreadsheet data (A1 notation) |
SheetsWrite | Write/append spreadsheet data |
SheetsCreate | Create a new spreadsheet |
CalendarList | List calendar events |
CalendarCreate | Create a calendar event |
CalendarUpdate | Update a calendar event |
DocsRead | Read a Google Doc |
DocsCreate | Create a Google Doc |
DocsUpdate | Update a Google Doc |
DriveList | List Drive files |
DriveDownload | Download a file from Drive |
Safe Tools
The following tools are automatically approved inauto permission mode:
ReadFiles, Grep, Glob, WebFetch, Explore, TaskAdd, TaskList, TaskUpdate, PlannerQuestion, SubmitPlan, LoadSkill