Tools Reference

All 58 tools available to the AI, organized by category. Each tool is designed for LLM consumption with structured parameters and clear feedback.

ℹ️ Tool management Tools can be enabled/disabled at runtime via the tool_manage tool or the Configuration panel. Some tools require specific modules to be active (e.g., web search requires API keys).

📁 File Tools

Open

File

Opens a file and adds it to context. Always use before Edit to see current content — you need exact text for replacements.

Edit

File

Edits a file by replacing exact text. Preferred over Write for modifications — finds old_string and replaces with new_string. Supports replace_all and skip_callbacks.

Write

File

Creates a new file or completely replaces all content. Only for new files or full rewrites — use Edit for targeted changes.

🧭 Context Tools

Close_panel

Context

Removes items from context by their IDs. Cannot close core panels (P1-P6).

ask_user_question

Context

Presents 1-4 multiple-choice questions as an interactive form. Replaces input field until answered. Each question has 2-4 options plus auto-appended "Other" free-text.

Close_conversation_history

Context

Closes a conversation history panel, creating log entries and memory items to preserve important information before the history is lost.

panel_goto_page

Context

Navigates paginated panels to a specific page. Used for large content that's split across pages.

🔀 Git Tools

git_execute

Git

Executes git commands. Read-only commands (log, diff, show, status, blame) create auto-refreshing panels. Mutating commands (commit, push, merge) execute directly. Shell operators not allowed.

gh_execute

Git

Executes GitHub CLI commands. Requires GITHUB_TOKEN. Read-only commands create auto-refreshing panels (120s). Mutating commands execute directly.

💻 Console Tools

console_create

Console

Spawns a background process with a monitoring panel. For one-shot commands (e.g., cargo build) or interactive shells (bash). Survives TUI reloads.

console_send_keys

Console

Sends input to a running console's stdin. Include \n for newline. Supports escape sequences: \x03 (Ctrl+C), \x04 (Ctrl+D), arrow keys.

console_wait

Console

Blocking wait for process exit or regex pattern match. Best for sequential workflows (build then test). Use regex alternation for success AND failure patterns.

console_watch

Console

Async watcher — registers a notification for process exit or pattern match without blocking. Best for long-running servers.

console_easy_bash

Console

Quick synchronous command execution (max 10s). Returns stdout+stderr directly. For debugging and one-off commands only.

🌳 Tree Tools

tree_filter

Tree

Configures a gitignore-style filter for the directory tree view. Controls which files/folders are visible.

tree_toggle

Tree

Opens or closes folders in the directory tree. Closed folders show child count, open folders show contents.

tree_describe

Tree

Adds descriptions to files/folders in the tree. Descriptions appear next to items. A [!] marker indicates the file changed since the description was written.

👤 Agent & Prompt Tools

agent_create

Agent

Creates a new agent with a name, description, and system prompt. Agents define the AI's identity and behavior.

agent_load

Agent

Activates an agent as the current system prompt. Pass empty ID to revert to default.

agent_delete

Agent

Deletes an agent. Built-in agents cannot be deleted.

Edit_prompt

Agent

Edits an agent, skill, or command by replacing exact text in its content. Routes automatically based on ID.

Library_open_prompt_editor / Library_close_prompt_editor

Agent

Opens/closes a prompt's content in the Library panel for reading and editing. Required before using Edit_prompt.

📚 Skill Tools

skill_create

Skill

Creates a new skill. Skills are loaded as context panels that provide additional instructions or knowledge.

skill_load / skill_unload

Skill

Loads a skill as a context panel (visible to the AI) or unloads it to free context space.

skill_delete

Skill

Deletes a skill. Built-in skills cannot be deleted.

⚡ Command Tools

command_create

Command

Creates a slash command. Commands are inline replacements triggered by /command-name in the input field.

command_delete

Command

Deletes a command. Built-in commands cannot be deleted.

🧠 Memory Tools

memory_create

Memory

Creates persistent memory items with importance levels (low/medium/high/critical) and optional labels for categorization.

memory_update

Memory

Updates or deletes existing memory items. Can change content, importance, labels, or toggle the rich body view.

✅ Todo Tools

todo_create

Todo

Creates one or more todo items. Supports nesting via parent_id for hierarchical task lists.

todo_update

Todo

Updates existing todos: change status (pending/in_progress/done/deleted), name, description, or delete.

todo_move

Todo

Reorders a todo in the list. Place after another todo, or at the top.

📝 Scratchpad Tools

scratchpad_create_cell

Scratchpad

Creates a scratchpad cell for temporary notes, code snippets, or data during the conversation.

scratchpad_edit_cell

Scratchpad

Edits an existing scratchpad cell. Can update title and/or contents.

scratchpad_wipe

Scratchpad

Deletes scratchpad cells by ID. Pass empty array to wipe all cells.

🔔 Callback Tools

Callback_upsert

Callback

Creates, updates, or deletes file edit callbacks. Callbacks are bash scripts that auto-fire when AI edits files matching a glob pattern. Supports blocking mode and one-at-a-time execution.

Callback_toggle

Callback

Activates or deactivates a callback for the current worker. Doesn't modify the callback definition.

Callback_open_editor / Callback_close_editor

Callback

Opens/closes a callback's script content in the Callbacks panel for reading and editing.

💡 Escalation Tiers Web tools follow a tier system: brave_search (Tier 1) → brave_llm_context (Tier 2) → firecrawl_scrape/search (Tier 3) → firecrawl_map (Tier 4). Start at the lowest tier and escalate only if needed.

brave_search

Web Search

Search the web via Brave's 40-billion-page index. Returns snippets, URLs, and rich results. Supports search operators ("exact", -exclude, site:domain) and Brave Goggles for domain re-ranking. Tier 1 — always try first.

brave_llm_context

Web Search

Pre-extracted, relevance-scored web content optimized for LLM consumption. Configurable token budget (1K-32K) and threshold modes. Tier 2 — when snippets aren't enough.

🔍 Web Scrape Tools

firecrawl_scrape

Web Scrape

Full-page content extraction from a known URL via headless Chromium. Returns clean markdown (~67% fewer tokens than raw HTML). Tier 3a — when you have a specific URL.

firecrawl_search

Web Scrape

Combined search + scrape in a single API call. Categories: github, research, pdf. Time filters available. Tier 3b — when you need full pages without specific URLs.

firecrawl_map

Web Scrape

Discovers all URLs on a domain via sitemap + SERP + cached crawl data. 1 credit per call. Tier 4 — for site exploration.

📄 PDF Tools

typst_execute

PDF

Runs Typst commands via the embedded compiler. Subcommands: compile, init, watch, unwatch, watchlist, fonts, query, update. Auto-downloads @preview/ packages from Typst Universe.

🦴 Spine Tools

spine_configure

Spine

Configures auto-continuation behavior and guard rail limits: max cost, max messages, max tokens, max duration. Toggle continue_until_todos_done for autonomous workflows.

notification_mark_processed

Spine

Marks spine notifications as processed, indicating they've been addressed.

coucou

Spine

Schedules a notification to fire after a delay (timer mode) or at a specific time (datetime mode). For reminders, delayed checks, or timed follow-ups.

⚙️ System Tools

system_reload

System

Reloads the TUI application. State is preserved. Use after modifying source code and rebuilding.

tool_manage

System

Enables or disables individual tools at runtime. Cannot disable itself.

module_toggle

System

Activates or deactivates entire modules. Deactivating removes the module's tools and panels. Cannot deactivate a module if another active module depends on it.

preset_snapshot_myself / preset_load

System

Save or load named presets capturing: active agent, modules, disabled tools, worker data, and dynamic panels. Messages are preserved across loads.

📋 Log Tools

log_create

Log

Creates timestamped log entries for recording decisions, actions, or notable events.

log_summarize

Log

Summarizes multiple top-level log entries into a single collapsible parent. Minimum 4 entries required.

log_toggle

Log

Expands or collapses a log summary to show or hide its children.