Insites Docs Developers guide Building with AICloudShellCloudShell Tools

AI answers drawn only from these docs, with links to the pages used.

CloudShell Tools

Last updated on October 15, 2026.

Every tool your AI assistant can use through Insites CloudShell, with example prompts.

CloudShell gives your AI assistant a set of tools for working with your Insites instance. You never call these yourself: describe what you want in plain language and your AI picks the right tool. This page lists every tool so you know what is possible, with an example prompt for each.

Instances

ToolWhat it doesExample prompt
insites_list_instancesLists every instance in the Insites accounts you belong to, and shows which one is selected.Which Insites instances can I work on?
insites_select_instanceSelects the instance that every other tool works on. The selection is remembered until you change it.Select my staging instance.

Deploying

ToolWhat it doesExample prompt
insites_deployDeploys one or more small files, with their contents sent directly. Best for files under about 32 KB.Deploy the updated homepage and header partial.
insites_sync_fileDeploys a single small file immediately. Useful for quick edits during development.Sync just the navigation partial.
insites_request_uploadCreates a one-time upload link for a large file, so the file goes straight from your computer to CloudShell instead of through the AI.Deploy the 200 KB stylesheet in my assets folder.
insites_commit_uploadDeploys a file that was sent through an upload link. Will not replace a file CloudShell knows is there unless asked, and keeps the replaced file for 30 days.(Used automatically after an upload.)
insites_upload_assetDeploys an image, font, or PDF through an upload link and returns its public URL. Supports PNG, JPG, SVG, WebP, GIF, WOFF, WOFF2, and PDF.Upload logo.png and use it in the header.
insites_deploy_from_urlDeploys a file from a public https address. Built for web-based AI assistants that cannot read your files.Deploy the file at https://example.com/home.liquid as my homepage.
insites_deploy_statusReports the progress of a deploy started from an upload or a link.Has that deploy finished?

Deployment History and Logs

ToolWhat it doesExample prompt
insites_deploymentsLists recent deploys from every source (your AI, direct uploads, and GitHub) with status, size, and time.Show me the last ten deploys.
insites_deploy_statsSummarizes deploy activity for the current week and the last seven days.How many times did we deploy this week?
insites_get_logsFetches recent logs from your instance.Check the logs for errors since the last deploy.

Environment and Modules

ToolWhat it doesExample prompt
insites_env_getLists the environment variables set on your instance.What environment variables are set?
insites_env_addAdds an environment variable, or updates one that already exists.Set MAPS_API_KEY to the key I just gave you.
insites_module_listLists the modules installed on your instance.Which modules are installed?

GitHub

These tools work with the Insites GitHub App.

ToolWhat it doesExample prompt
insites_github_connectCreates a link to install the Insites GitHub app and connect a repository to your instance.Connect GitHub to my instance.
insites_github_statusShows the connected repository, the watched branch, and when it was connected.Which repository is connected?
insites_github_update_branchChanges the branch your instance watches. Pushes to that branch deploy automatically.Deploy from the staging branch from now on.
insites_github_treeLists the files in the connected repository, or in one folder of it.Show me what is in app/views/pages.
insites_github_pullReads one file from the repository.Open the homepage from the repository.
insites_github_pull_batchReads several files from the repository in one request.Read all the layout files.
insites_github_pushCommits files to the watched branch, which deploys them automatically.Commit the new contact page.
insites_github_push_branchCommits files to another branch, creating it if needed. Nothing deploys until it is merged into the watched branch.Push this work to a branch called feature/contact-form.
insites_github_commitsLists recent commits with their message, author, and date.What changed in the last five commits?
insites_github_list_deploymentsLists recent deploys triggered by GitHub pushes.Did my last push deploy?
insites_github_revertAdds a commit that puts the repository back as it was before the chosen commit. It lands on the watched branch, so it deploys like any other push.Revert the last commit and deploy.
insites_github_disconnectDisconnects the repository. Future pushes stop deploying.Disconnect GitHub from this instance.

Troubleshooting

CloudShell tools do not appear

Check that CloudShell is added with the address https://cloudshell.insites.io/mcp and that you have signed in. In Claude Code, run /mcp to see its status and authenticate again if needed. Some assistants only load new tools after a restart.

An instance is missing from the list

CloudShell lists the instances in the Insites accounts you belong to. If one is missing, ask the account owner to add you in the Console.

A tool is refused on an instance

Your role on that instance does not allow it. By default, reading logs and history needs Viewer, setting environment variables and pushing to a branch needs Editor, and deploying needs Developer or above. Ask the account owner to change your role.

A change went to the wrong instance

Every tool works on the selected instance, and the selection is remembered across conversations. Ask your AI which instance is selected, select the right one, and deploy again.

A large file arrives incomplete

Files over about 32 KB should go through an upload rather than being sent directly. Ask your AI to deploy the file using an upload link.

An upload will not replace a file

An upload does not replace a file that CloudShell knows is on your instance unless you ask. This includes a file that reached the instance another way, such as from GitHub, the Insites CLI or the Instance Admin. Tell your AI that you want to replace the file. CloudShell keeps a copy of the replaced file for 30 days. See Undoing a Change.

A deploy fails

Ask your AI to check the deploy status and the instance logs. It can read the error and fix the file. Check that the file path starts with app/ or modules/.

Have a suggestion for this page?

Didn't quite find what you are looking for or have feedback on how we can make the content better then we would love to hear from you. Please provide us feedback and we will get back to you shortly.