Command Reference · 73 Commands

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); every shell command line is classified into four risk tiers and has to pass checkShellPermission. With the default settings, nothing runs until the approval dialog is answered — one command at a time.

How commands are parsed

1. JSON (tried first) — ```json blocks and bare { "commands": [...] } / { "type": ..., "value": ... } objects, parsed with a balanced-brace scanner.
2. HTML comment —  ...  containing [TYPE]:value lines.
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 a risk field and reason; default risk is medium.

Source: src/lib/AICommandParser.ts:374-513, src/lib/AICommandParser.ts:62-138, src/components/ai/AIConstants.ts:96-108

Native API API Reference

Risk:

Low

Medium

High

NAVIGATE

Bracket/JSON Format

Low Risk

Navigate to a specific URL. Supports HTTP, HTTPS, and file:// URLs.

Parameters (1 required)

url

Instant

SEARCH

Bracket Format

Low Risk

Perform a web search using the default search engine.

Parameters (1 required)

query

Instant

WEB_SEARCH

Bracket Format

Low Risk

Perform a real-time web search with RAG (Retrieval Augmented Generation) for up-to-date information.

Parameters (1 required)

query

Instant

RELOAD

Bracket Format

Low Risk

Refresh the current browser tab.

Parameters (0 required)

Instant

GO_BACK

Bracket Format

Low Risk

Navigate back in browser history.

Parameters (0 required)

Instant

GO_FORWARD

Bracket Format

Low Risk

Navigate forward in browser history.

Parameters (0 required)

Instant

READ_PAGE_CONTENT

Bracket Format

Low Risk

Extract and read text content from the active browser tab.

Parameters (0 required)

Instant

LIST_OPEN_TABS

Bracket Format

Low Risk

List all currently open browser tabs with their titles and URLs.

Parameters (0 required)

Instant

CREATE_PDF_JSON

JSON Format

Low Risk

Generate a structured, multi-page PDF document with advanced formatting options. PREFERRED method.

Parameters (2 required)

titletemplatecontentbranding+1 more

Instant

CREATE_FILE_JSON

JSON Format

Low Risk

Create various file formats (PDF, PPTX, DOCX) using structured JSON. Supports rich media slides.

Parameters (3 required)

formattitleslides

Instant

SHELL_COMMAND

JSON Format

High Risk

Execute terminal commands on the host operating system. With the default settings every command waits for an explicit approval before it runs.

Parameters (1 required)

commandshell

Requires Approval

SET_VOLUME

Bracket Format

Low Risk

Adjust the system volume level.

Parameters (1 required)

level

Instant

SET_BRIGHTNESS

Bracket Format

Low Risk

Adjust the display brightness level.

Parameters (1 required)

level

Instant

OPEN_APP

Bracket Format

Medium Risk

Launch an application on the host system.

Parameters (1 required)

appurl

Requires Approval

OCR_SCREEN

JSON Format

Low Risk

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)

region

Instant

LIST_AUTOMATIONS

Bracket Format

Low Risk

List all scheduled automation tasks with their status and schedules.

Parameters (0 required)

Instant

DELETE_AUTOMATION

Bracket Format

Low Risk

Delete an automation task using its ID.

Parameters (1 required)

taskId

Requires Approval

SCHEDULE_TASK

JSON Format

Low Risk

Schedule a recurring automation task that runs through the background service even when the browser is closed.

Parameters (3 required)

scheduletypename

Instant

THINK

JSON Format

Low Risk

Expose the model's reasoning or intermediate thinking to the user for complex tasks.

Parameters (1 required)

reasoning

Instant

PLAN

JSON Format

Low Risk

Show the intended execution steps for a multi-step task before or during execution.

Parameters (1 required)

steps

Instant

PLUGIN_COMMAND

Bracket Format

Medium Risk

Execute a command defined by a plugin. Format: pluginId.commandName | params.

Parameters (1 required)

pluginCommandparams

Requires Approval

CLICK_ELEMENT

JSON/Bracket Format

Medium Risk

Click on a visible DOM element using visual intelligence (OCR + coordinate mapping).

Parameters (1 required)

textmatchTypeindex

Requires Approval

FIND_AND_CLICK

JSON/Bracket Format

Medium Risk

Find text on the current page and click nearby elements. Uses OCR for text detection.

Parameters (1 required)

findTextclickText

Requires Approval

FILL_FORM

JSON/Bracket Format

Medium Risk

Fill in form fields identified by label, placeholder, or name.

Parameters (2 required)

fieldsfields[].labelfields[].namefields[].value

Requires Approval

MULTI_FILL_FORM

JSON Format

Medium Risk

Fill multiple form fields atomically from a JSON field map. Uses dom-engine v2 with AX-tree resolution and cascading fallbacks.

Parameters (1 required)

fields

Requires Approval

DOM_SEARCH

JSON Format

Low Risk

Search within the current page DOM for elements matching a selector, text, or attribute. Returns matching elements with metadata.

Parameters (1 required)

querymaxResults

Instant

SWITCH_TAB

Bracket Format

Low Risk

Switch to a specific browser tab by ID or index.

Parameters (1 required)

tabId

Instant

CLOSE_TAB

Bracket Format

Low Risk

Close a specific browser tab by ID.

Parameters (1 required)

tabId

Instant

SCROLL_TO

JSON Format

Low Risk

Scroll to a DOM element on the current page.

Parameters (1 required)

selector

Instant

CLICK_AT

JSON Format

Medium Risk

Click at specific screen coordinates (x, y).

Parameters (2 required)

xy

Requires Approval

SCREENSHOT_AND_ANALYZE

JSON Format

Low Risk

Capture a screenshot of the current page and analyze its visual content using Vision/OCR.

Parameters (0 required)

Instant

DEEP_RESEARCH

JSON Format

Low Risk

Perform deep iterative research with source ranking and coverage analysis across multiple search queries.

Parameters (1 required)

querydepth

Instant

ORGANIZE_TABS

JSON Format

Low Risk

Use AI to intelligently group all open tabs by topic or domain.

Parameters (0 required)

Instant

ENABLE_CLI

JSON Format

Medium Risk

Automatically enable the Aartiq CLI terminal tool for command-line browser control.

Parameters (0 required)

Requires Approval

GENERATE_PDF

JSON Format

Low Risk

Create a PDF from markdown content (legacy fallback). For structured documents, prefer CREATE_PDF_JSON.

Parameters (1 required)

contentfilename

Instant

GENERATE_DIAGRAM

JSON Format

Low Risk

Create charts and diagrams using Mermaid.js syntax.

Parameters (2 required)

typecontent

Instant

GENERATE_IMAGE

JSON Format

Low Risk

Generate an AI image with a detailed text prompt.

Parameters (1 required)

promptstyle

Instant

APPLE_INTELLIGENCE_IMAGE

JSON Format

Low Risk

Generate an image using Apple Intelligence local models (macOS only).

Parameters (1 required)

prompt

Instant

APPLE_INTELLIGENCE_SUMMARY

JSON Format

Low Risk

Summarize text using Apple Intelligence local models (macOS only).

Parameters (1 required)

text

Instant

PLAY_VIDEO

JSON Format

Low Risk

Play a YouTube video inline in the chat interface.

Parameters (1 required)

url

Instant

SEARCH_VIDEO

JSON Format

Low Risk

Search YouTube and auto-play the top result.

Parameters (1 required)

query

Instant

LIST_BOOKMARKS

Bracket Format

Low Risk

List all saved browser bookmarks.

Parameters (0 required)

Instant

ADD_BOOKMARK

JSON Format

Low Risk

Add a bookmark for the current page or a specific URL.

Parameters (1 required)

urltitle

Instant

REMOVE_BOOKMARK

JSON Format

Low Risk

Remove a bookmark by URL.

Parameters (1 required)

url

Requires Approval

CLEAR_BOOKMARKS

Bracket Format

High Risk

Remove all bookmarks.

Parameters (0 required)

Requires Approval

LIST_HISTORY

JSON Format

Low Risk

List or search browsing history.

Parameters (0 required)

querylimit

Instant

CLEAR_HISTORY

Bracket Format

High Risk

Clear all browsing history.

Parameters (0 required)

Requires Approval

LIST_SKILLS

Bracket Format

Low Risk

List all available skill guides that can be loaded for domain-specific knowledge.

Parameters (0 required)

Instant

LOAD_SKILL

JSON Format

Low Risk

Load a specific skill guide into context for domain-specific knowledge and workflows.

Parameters (1 required)

skillId

Instant

SETTINGS_QUERY

JSON Format

Low Risk

Read current settings for a specific category.

Parameters (1 required)

category

Instant

SETTINGS_UPDATE

JSON Format

Medium Risk

Request a settings change. Changes are applied after user confirmation.

Parameters (3 required)

categorykeyvalue

Requires Approval

OPEN_SETTINGS_PANEL

JSON Format

Low Risk

Open a specific settings panel in the UI.

Parameters (1 required)

panel

Instant

EXPLAIN_CAPABILITIES

JSON Format

Low Risk

List all available AI features and capabilities of Aartiq.

Parameters (0 required)

Instant

SEARCH_RESULTS

JSON Format

Low Risk

Fetch Google search result URLs directly, without opening a tab.

Parameters (1 required)

querycount

Instant

OPEN_VIEW

Bracket Format

Low Risk

Switch between browser workspace views.

Parameters (1 required)

view

Instant

DOM_READ_FILTERED

Bracket Format

Low Risk

Read DOM text with an optional filter term, screened through the injection check before it is returned.

Parameters (0 required)

term

Instant

ANALYSE_TABS

JSON Format

Low Risk

Analyse all open tabs — list them, read their content, and return one consolidated analysis.

Parameters (0 required)

Instant

ANALYZE_TABS

JSON Format

Low Risk

US-spelling variant — the parser normalizes it to ANALYSE_TABS and runs the same analysis.

Parameters (0 required)

Instant

SUMMARIZE_TABS

JSON Format

Low Risk

Summarize content from one or more open tabs — the parser normalizes it to the ANALYSE_TABS flow.

Parameters (0 required)

Instant

READ_TAB_CONTENT

JSON Format

Low Risk

Read the content of one specific open tab.

Parameters (1 required)

tabId

Instant

COMPARE_TABS

JSON Format

Low Risk

Compare content across multiple open tabs.

Parameters (1 required)

tabIds

Instant

FIND_INFORMATION_IN_TABS

JSON Format

Low Risk

Search open tabs for specific information.

Parameters (1 required)

query

Instant

CREATE_TAB_RESEARCH_CONTEXT

JSON Format

Low Risk

Create a research context from the currently open tabs.

Parameters (0 required)

Instant

GROUP_TABS

JSON Format

Low Risk

Group open tabs by strategy: ai, domain, priority, or recency.

Parameters (0 required)

strategy

Instant

RECORD_WORKFLOW

Bracket Format

Low Risk

Start or stop workflow recording — actions taken while recording are captured as a replayable step list.

Parameters (1 required)

action

Instant

PLAY_WORKFLOW

Bracket Format

Medium Risk

Replay a previously recorded workflow, step by step.

Parameters (1 required)

name

Requires Approval

OPEN_AUTOMATION_SETTINGS

Bracket Format

Low Risk

Open the automation settings panel.

Parameters (0 required)

Instant

OPEN_SCHEDULING_MODAL

Bracket Format

Low Risk

Open the scheduling modal, optionally pre-filled from a pipe-separated cron | type | name | description string.

Parameters (0 required)

prefill

Instant

WAIT

Bracket Format

Low Risk

Pause execution for a duration in milliseconds.

Parameters (1 required)

ms

Instant

STATUS

JSON Format

Low Risk

Show a custom processing indicator to the user.

Parameters (1 required)

text

Instant

OPEN_MCP_SETTINGS

Bracket Format

Low Risk

Open the MCP servers settings panel.

Parameters (0 required)

Instant

SET_THEME

Bracket Format

Low Risk

Switch between dark and light mode.

Parameters (1 required)

theme

Instant

SET_CHAT_STYLE

JSON Format

Low Risk

Customize chat font size, glow mode and preset.

Parameters (0 required)

fontSizeglowModeglowPreset

Instant

Quick Command Reference

NAVIGATE

SEARCH

WEB_SEARCH

RELOAD

GO_BACK

GO_FORWARD

READ_PAGE_CONTENT

LIST_OPEN_TABS

CREATE_PDF_JSON

CREATE_FILE_JSON

SHELL_COMMAND

SET_VOLUME

SET_BRIGHTNESS

OPEN_APP

OCR_SCREEN