The AI tools

The tools your assistant gets from Tiledash, for looking things up while it works.

The tools

These are the tools the assistant has. It picks them itself, so you never need to name one.

Tool	What it does
`get_guide`	Reads the widget authoring guide, by topic.
`get_changelog`	Reads what changed in Tiledash, release by release.
`list_widgets`	Lists your own widgets and Tiledash’s built-in ones.
`get_widget`	Reads a widget: its template, style, settings and saves.
`create_widget`	Makes a new widget, from a built-in, one of yours or empty.
`save_widget`	Saves a change to one of your widgets, live at once.
`restore_widget_save`	Makes an earlier save live again, as a new save.
`check_widget`	Checks a widget without saving it.
`render_widget`	Shows what a widget draws for a device, as markup.
`get_preview_url`	Gives the live preview link to look at a widget, a partial, a model, a theme, or a dashboard or floor plan draft.
`open_in_editor`	Gives the link to a widget in Tiledash’s editor.
`list_partials`	Lists your partials, those you installed and Tiledash’s.
`get_partial`	Reads a partial.
`save_partial`	Makes or changes one of your partials, with its parameters.
`render_partial`	Shows what a partial draws for the values you give it.
`list_devices`	Lists your devices with their capabilities and readings.
`list_test_devices`	Lists your test devices.
`create_test_device`	Makes a test device with the capabilities you choose.
`update_test_device`	Changes a test device’s values or capabilities.
`list_themes`	Lists the themes you can pick.
`get_theme`	Reads a theme: its colours, fonts, saves and contrast.
`create_theme`	Makes a theme of yours, from a built-in, one of yours or a Community one.
`save_theme`	Saves a change to one of your themes, live at once.
`check_theme`	Checks a theme change without saving it.
`restore_theme_save`	Makes an earlier save of a theme live again.
`make_other_half`	Makes the light or dark half of one of your themes, and pairs them.
`pair_themes`	Pairs two of your themes, one light and one dark.
`unpair_theme`	Makes the halves of a pair two themes of their own again.
`list_models`	Lists your floor plan models and those you installed.
`get_floor_plan_appearance`	Reads the appearance groups and choices of a placed model.
`preview_floor_plan_appearance`	Previews colours and finishes on one placed model without changing the plan.
`apply_floor_plan_appearance`	Applies the exact appearance preview approved in chat.
`get_model`	Reads a model: its parts, how it is fitted and its saves.
`draw_model`	Draws a model from parts as a picture, without keeping it.
`create_model`	Makes a new floor plan model from parts.
`save_model`	Saves a change to one of your models, live on your plans.
`restore_model_save`	Makes an earlier save of a model live again.
`check_model_publish`	Checks a model and reads its Community publishing details.
`publish_model`	Publishes your model or a new version after approval in chat.
`fit_model`	Turns, sizes or places one of your models, or says what it is.
`get_model_upload_url`	Gives a one-time address to send a finished model file to.
`get_model_job`	Says how a change to a model that is still being made is going.
`list_floor_plans`	Lists your floor plans with their levels and rooms.
`get_floor_plan`	Reads a floor plan, one level whole.
`create_floor_plan_draft`	Starts a separate floor plan draft.
`get_floor_plan_draft`	Reads a floor plan draft and what applying it removes.
`edit_floor_plan_draft`	Changes a floor plan draft part by part: rooms, walls, doors, furniture and devices.
`draw_floor_plan_draft`	Draws one level of a floor plan draft from above and in 3D, so the assistant can check its work.
`discard_floor_plan_draft`	Discards a floor plan draft without changing your plan.
`apply_floor_plan_draft`	Applies the exact floor plan draft version you approved in chat.
`list_pictures`	Lists your pictures and Tiledash’s, for wallpapers and tiles.
`get_picture`	Shows a small copy of one picture.
`get_picture_upload_url`	Gives a one-time address to add a picture to your library.
`delete_widget`	Deletes one of your widgets after approval in chat.
`delete_partial`	Deletes one of your partials after approval in chat.
`delete_theme`	Deletes one of your themes after approval in chat.
`delete_model`	Deletes one of your floor plan models after approval in chat.
`delete_test_device`	Deletes one of your test devices after approval in chat.

Working from files

The tiledash command works with folders of files, but only to publish to the community and to pull published versions: it can’t change your own widgets yet. To have an assistant edit your widgets, use the connection above.

Widgets you build this way are the same as the ones you write: How a widget works explains what is in one.

Dashboard tools

Tool	What it does
`get_dashboard_context`	Reads your Homey resources and usable built-in, custom and Community widgets.
`list_dashboards`	Lists your dashboards.
`get_dashboard`	Reads a dashboard and its draft-compatible document.
`create_dashboard_draft`	Starts a separate dashboard draft.
`get_dashboard_draft`	Reads a draft and its removal summary.
`save_dashboard_draft`	Saves a complete draft with responsive layouts and nested tiles.
`discard_dashboard_draft`	Discards a draft without changing your screens.
`apply_dashboard_draft`	Applies the exact draft version you approved in chat.
`search_community`	Searches the full Community catalog of widgets, themes, partials or models.
`get_community_item`	Reads a Community item and an exact version package.
`install_community_item`	Installs an exact version of a Community widget, theme, partial or model after approval.