Command Reference
Aartiq turns AI output into structured commands before anything runs. The parser is JSON-first, then HTML-comment, then bracket tags. The shell verb is SHELL_COMMAND (there is no RUN_SHELL); it is rated HIGH risk and never auto-executes. Commands are executed one at a time with per-step human approval.
How commands are parsed
- 1. JSON (tried first) —
```jsonblocks and bare{ "commands": [...] }/{ "type": ..., "value": ... }objects, parsed with a balanced-brace scanner. - 2. HTML comment —
<!-- AI_COMMANDS_START --> ... <!-- AI_COMMANDS_END -->containing[TYPE]:valuelines. - 3. Bracket tags —
[NAVIGATE: https://example.com],[FILL_FORM: #email | user@example.com],[CLICK_ELEMENT: #submit | click submit]. - Text inside code blocks, inline code,
<think>blocks, and markdown tables is masked so it is not re-parsed. A command may carry ariskfield andreason; default risk ismedium.
Source: src/lib/AICommandParser.ts:374-513, src/lib/AICommandParser.ts:62-138, src/components/ai/AIConstants.ts:96-108
Risk:
NAVIGATE
Bracket/JSON Format
Navigate to a specific URL. Supports HTTP, HTTPS, and file:// URLs.
Parameters (1 required)
urlSEARCH
Bracket Format
Perform a web search using the default search engine.
Parameters (1 required)
queryWEB_SEARCH
Bracket Format
Perform a real-time web search with RAG (Retrieval Augmented Generation) for up-to-date information.
Parameters (1 required)
queryRELOAD
Bracket Format
Refresh the current browser tab.
Parameters (0 required)
GO_BACK
Bracket Format
Navigate back in browser history.
Parameters (0 required)
GO_FORWARD
Bracket Format
Navigate forward in browser history.
Parameters (0 required)
READ_PAGE_CONTENT
Bracket Format
Extract and read text content from the active browser tab.
Parameters (0 required)
LIST_OPEN_TABS
Bracket Format
List all currently open browser tabs with their titles and URLs.
Parameters (0 required)
CREATE_PDF_JSON
JSON Format
Generate a structured, multi-page PDF document with advanced formatting options. PREFERRED method.
Parameters (2 required)
titletemplatecontentbranding+1 moreCREATE_FILE_JSON
JSON Format
Create various file formats (PDF, PPTX, DOCX) using structured JSON. Supports rich media slides.
Parameters (3 required)
formattitleslidesSHELL_COMMAND
JSON Format
Execute terminal commands on the host operating system. All shell commands require explicit user approval.
Parameters (1 required)
commandshellSET_VOLUME
Bracket Format
Adjust the system volume level.
Parameters (1 required)
levelSET_BRIGHTNESS
Bracket Format
Adjust the display brightness level.
Parameters (1 required)
levelOPEN_APP
Bracket Format
Launch an application on the host system.
Parameters (1 required)
appurlOCR_SCREEN
JSON Format
Capture the screen or a region and extract text. Aartiq uses native OS OCR and accessibility providers first, with image OCR as a fallback path.
Parameters (0 required)
regionOCR_COORDINATES
JSON Format
Resolve coordinates for visible text in desktop apps so Aartiq can target external UI reliably.
Parameters (1 required)
textthresholdCLICK_APP_ELEMENT
JSON Format
Click on an element in an external application using native-first visual matching and coordinate resolution.
Parameters (2 required)
apptextxyLIST_AUTOMATIONS
Bracket Format
List all scheduled automation tasks with their status and schedules.
Parameters (0 required)
DELETE_AUTOMATION
Bracket Format
Delete an automation task using its ID.
Parameters (1 required)
taskIdSCHEDULE_TASK
JSON Format
Schedule a recurring automation task that runs through the background service even when the browser is closed.
Parameters (3 required)
scheduletypenameTHINK
JSON Format
Expose the model's reasoning or intermediate thinking to the user for complex tasks.
Parameters (1 required)
reasoningPLAN
JSON Format
Show the intended execution steps for a multi-step task before or during execution.
Parameters (1 required)
stepsPLUGIN_COMMAND
Bracket Format
Execute a command defined by a plugin. Format: pluginId.commandName | params.
Parameters (1 required)
pluginCommandparamsCLICK_ELEMENT
JSON/Bracket Format
Click on a visible DOM element using visual intelligence (OCR + coordinate mapping).
Parameters (1 required)
textmatchTypeindexFIND_AND_CLICK
JSON/Bracket Format
Find text on the current page and click nearby elements. Uses OCR for text detection.
Parameters (1 required)
findTextclickTextFILL_FORM
JSON/Bracket Format
Fill in form fields identified by label, placeholder, or name.
Parameters (2 required)
fieldsfields[].labelfields[].namefields[].valueMULTI_FILL_FORM
JSON Format
Fill multiple form fields atomically from a JSON field map. Uses dom-engine v2 with AX-tree resolution and cascading fallbacks.
Parameters (1 required)
fieldsDOM_SEARCH
JSON Format
Search within the current page DOM for elements matching a selector, text, or attribute. Returns matching elements with metadata.
Parameters (1 required)
querymaxResultsSWITCH_TAB
Bracket Format
Switch to a specific browser tab by ID or index.
Parameters (1 required)
tabIdCLOSE_TAB
Bracket Format
Close a specific browser tab by ID.
Parameters (1 required)
tabIdSCROLL_TO
JSON Format
Scroll to a DOM element on the current page.
Parameters (1 required)
selectorCLICK_AT
JSON Format
Click at specific screen coordinates (x, y).
Parameters (2 required)
xySCREENSHOT_AND_ANALYZE
JSON Format
Capture a screenshot of the current page and analyze its visual content using Vision/OCR.
Parameters (0 required)
DEEP_RESEARCH
JSON Format
Perform deep iterative research with source ranking and coverage analysis across multiple search queries.
Parameters (1 required)
querydepthORGANIZE_TABS
JSON Format
Use AI to intelligently group all open tabs by topic or domain.
Parameters (0 required)
ENABLE_CLI
JSON Format
Automatically enable the Aartiq CLI terminal tool for command-line browser control.
Parameters (0 required)
GENERATE_PDF
JSON Format
Create a PDF from markdown content (legacy fallback). For structured documents, prefer CREATE_PDF_JSON.
Parameters (1 required)
contentfilenameGENERATE_DIAGRAM
JSON Format
Create charts and diagrams using Mermaid.js syntax.
Parameters (2 required)
typecontentGENERATE_IMAGE
JSON Format
Generate an AI image with a detailed text prompt.
Parameters (1 required)
promptstyleAPPLE_INTELLIGENCE_IMAGE
JSON Format
Generate an image using Apple Intelligence local models (macOS only).
Parameters (1 required)
promptAPPLE_INTELLIGENCE_SUMMARY
JSON Format
Summarize text using Apple Intelligence local models (macOS only).
Parameters (1 required)
textPLAY_VIDEO
JSON Format
Play a YouTube video inline in the chat interface.
Parameters (1 required)
urlSEARCH_VIDEO
JSON Format
Search YouTube and auto-play the top result.
Parameters (1 required)
queryLIST_BOOKMARKS
Bracket Format
List all saved browser bookmarks.
Parameters (0 required)
ADD_BOOKMARK
JSON Format
Add a bookmark for the current page or a specific URL.
Parameters (1 required)
urltitleREMOVE_BOOKMARK
JSON Format
Remove a bookmark by URL.
Parameters (1 required)
urlCLEAR_BOOKMARKS
Bracket Format
Remove all bookmarks.
Parameters (0 required)
LIST_HISTORY
JSON Format
List or search browsing history.
Parameters (0 required)
querylimitCLEAR_HISTORY
Bracket Format
Clear all browsing history.
Parameters (0 required)
LIST_SKILLS
Bracket Format
List all available skill guides that can be loaded for domain-specific knowledge.
Parameters (0 required)
LOAD_SKILL
JSON Format
Load a specific skill guide into context for domain-specific knowledge and workflows.
Parameters (1 required)
skillIdSETTINGS_QUERY
JSON Format
Read current settings for a specific category.
Parameters (1 required)
categorySETTINGS_UPDATE
JSON Format
Request a settings change. Changes are applied after user confirmation.
Parameters (3 required)
categorykeyvalueOPEN_SETTINGS_PANEL
JSON Format
Open a specific settings panel in the UI.
Parameters (1 required)
panelEXPLAIN_CAPABILITIES
JSON Format
List all available AI features and capabilities of Aartiq.
Parameters (0 required)
Quick Command Reference
NAVIGATESEARCHWEB_SEARCHRELOADGO_BACKGO_FORWARDREAD_PAGE_CONTENTLIST_OPEN_TABSCREATE_PDF_JSONCREATE_FILE_JSONSHELL_COMMANDSET_VOLUMESET_BRIGHTNESSOPEN_APPOCR_SCREEN