holaOS
Skip to content

Runtime Tools

This page covers the tool surface the runtime currently projects into the shipped harness path. Instead of grouping the tools by internal projection layer, this page groups them by the kind of work they help the agent do.

The runtime still chooses which tools appear. The harness does not invent its own environment. But for readers, category is the more useful view than internal tool surface.

Workspace and Files

ToolWhat it does
readRead file contents or prior outputs without modifying workspace state.
editModify workspace files directly.
bashRun shell commands that may inspect or mutate workspace state.
grepSearch workspace file contents by pattern.
globFind files and paths by glob pattern.
listList directory contents and inspect workspace layout.

Todo and Coordination

ToolWhat it does
questionPause and ask the user for clarification or confirmation.
todowriteCreate or update the current working todo.
todoreadRead the current working todo.
skillConsult available embedded or workspace skills when they are relevant.

Research

ToolWhat it does
web_searchSearch the public web for exploratory research, source discovery, and approximate or aggregated answers.

Browser

These tools only appear for workspace sessions when the desktop browser bridge is available. Each workspace gets its own dedicated agent browser surface, so the agent does not interfere with the user's own browser space.

ToolWhat it does
browser_navigateNavigate the desktop browser to a URL for direct inspection or interaction on a specific live site when search results are not enough.
browser_open_tabOpen a URL in a new desktop browser tab so the agent can inspect or compare specific live pages without losing the current page state.
browser_get_stateRead the current desktop browser page, visible interactive elements, and optional screenshot.
browser_clickClick an interactive element from browser_get_state by index to continue a live browser workflow.
browser_typeType text into an interactive element from browser_get_state by index to search, filter, fill inputs, or continue a live browser workflow.
browser_pressSend a keyboard key to the currently focused element to submit forms, confirm dialogs, or continue keyboard-driven browser interaction.
browser_scrollScroll the current page vertically to load, inspect, or reach additional live content that is not yet visible.
browser_backGo back in the active browser tab history while preserving the live browser session state.
browser_forwardGo forward in the active browser tab history while preserving the live browser session state.
browser_reloadReload the active browser tab to refresh live page state before re-checking exact details.
browser_screenshotCapture a screenshot of the active browser tab when visual verification or interpretation is needed.
browser_list_tabsList open browser tabs and the active tab id so the agent can manage multi-tab workflows.

Onboarding

ToolWhat it does
holaboss_onboarding_statusRead the local onboarding status for the current workspace.
holaboss_onboarding_completeMark local workspace onboarding complete with a summary.

Cronjobs

ToolWhat it does
holaboss_cronjobs_listList local cronjobs for the current workspace.
holaboss_cronjobs_createCreate a local cronjob for the current workspace.
holaboss_cronjobs_getRead one local cronjob by id.
holaboss_cronjobs_updateUpdate one local cronjob by id.
holaboss_cronjobs_deleteDelete one local cronjob by id.

Image Generation

ToolWhat it does
image_generateGenerate an image file in the current workspace using the configured image generation provider and model.

Reports

ToolWhat it does
write_reportCreate a report artifact for the current workspace session, save it under outputs/reports/, and return stable report metadata so the chat reply can stay brief.

write_report exists for answers that should become a durable artifact instead of a long chat message. It is meant for research summaries, investigations, audits, plans, reviews, comparisons, timelines, and other evidence-heavy findings the operator may want to revisit later.