Reference

Troubleshooting

This page lists messages you may see in Sheeta AI and what to do about them. If your problem is not here, contact us at contact@sheeta.ai.

Installation

Windows shows a SmartScreen warning

The direct installer is not code-signed yet. Click More info, then Run anyway. To avoid the warning, install from the Microsoft Store instead. See Installation.

The Mac app does not open on an Intel Mac

Sheeta AI is built for Apple Silicon Macs only.

Updates do not install from the app on Windows

If you installed from the Microsoft Store, the Store manages updates. Click Update on Microsoft Store in Settings > Updates.

Connections

Database is not reachable

Check that:

  • The database is running.
  • The host, port and database name are correct.
  • A firewall or cloud network rule allows connections from your IP address.

Invalid username or password

The database rejected the login. Check the username and password in Connection Management. After cloning a project, you must enter credentials yourself, because they are not stored in Git.

Connection test failed

Sheeta AI shows the database's own error after Connection test failed:. Sheeta AI does not save a connection until its test passes.

Docker tunnel errors

  • Docker is unavailable: start Docker Desktop or your Docker engine. The tunnel works only with Docker on the same computer.
  • Docker container 'name' is not running: start the database container and check its name.
  • Failed to pull Docker tunnel proxy image: the first tunnel downloads a small proxy image, so check your internet connection.

I need an SSH tunnel or custom SSL settings

Sheeta AI does not support SSH tunnels or custom SSL certificates. SSL is turned on automatically for known cloud hosts.

BigQuery and Google Cloud

Authentication was cancelled or timed out

Google sign-in waits three minutes for you to finish in the browser. Click Try Again and complete the sign-in.

Invalid Service Account JSON

Paste the full contents of the service account key file, including the braces. Create a new JSON key if the file is damaged.

A query asks for a cost check

The estimated BigQuery cost is above your threshold. Select fewer columns or add filters, or raise the threshold in Settings > BigQuery.

Cloud SQL messages

See the troubleshooting section of Google Cloud SQL.

AI agent

Install Claude Code or Codex on this device

Sheeta AI could not find the claude or codex command. Install one of them (see Agent Setup), then click Refresh. If the command works in your terminal but Sheeta AI still cannot find it, quit and reopen Sheeta AI. On macOS, Sheeta AI reads your shell's PATH when it starts, so a newly installed command is found after a restart.

Log in to Claude Code or Codex on this device

The CLI is installed but not logged in. Check it in a terminal:

claude auth status

Log in with the CLI, then click Refresh in Sheeta AI.

Sheeta could not load available models

The CLI did not return its model list. Check that the CLI works in a terminal and that you are online, then click Refresh.

The selected model is no longer available

Click Refresh and pick another model in the model picker.

Nothing happens when I send a message

The agent needs an open project. Open a project folder and try again.

Image attachments are refused

The selected model does not accept images. Pick a model that does, such as any Claude model.

CLI and MCP

Failed to install CLI

The install folder may need administrator rights. Try again with an administrator account, then restart your terminal.

MCP setup asks for the CLI

Install the CLI in Settings > CLI before adding the MCP server to other tools.

sheeta rejects --project_path

Use --project-path with a hyphen. The example in Settings > CLI uses an underscore by mistake.

Git

Git is not installed or not found in PATH

Cloning and the Version Control panel use the git command. Install Git, then restart Sheeta AI.

File import

Unsupported file type

Imports accept CSV, XLSX, XLS, JSON and SQLite files. See Importing Data.

JSON import errors

The JSON file must contain an array of objects, an object of arrays or a single object, and the objects must have properties.