Troubleshooting/Error Codes

CLI Errors

Reference for CLI-related error codes (CLI-XXXX)

CLI-0001

Error Message: Failed to delete agents

Cause: The system encountered an error when attempting to delete one or more agents.

Solution:

  • Verify you have the correct permissions
  • Check if the agents still exist
  • Try deleting agents one by one
  • Check the logs for more specific error details

CLI-0002

Error Message: Failed to create project

Cause: The system encountered an error when attempting to create a new project.

Solution:

  • Verify you have the correct permissions
  • Check if a project with the same name already exists
  • Ensure all required project parameters are valid
  • Check the logs for more specific error details

CLI-0003

Error Message: Unable to authenticate user

Cause: The system could not authenticate your user credentials.

Solution:

  • Verify your username and password
  • Check if your authentication token is valid
  • Try logging in again
  • Ensure your account has not been locked or disabled

CLI-0004

Error Message: Environment variables not set

Cause: Required environment variables are missing or not properly set.

Solution:

  • Check which environment variables are required
  • Set the missing environment variables
  • Verify the environment variables have the correct values
  • Consider using a .env file for local development

CLI-0005

Error Message: API request failed

Cause: A request to the Agentuity API failed.

Solution:

  • Check your internet connection
  • Verify the API endpoint is correct
  • Ensure your authentication token is valid
  • Check the logs for more specific error details

CLI-0006

Error Message: Invalid configuration

Cause: The configuration file or parameters contain invalid values.

Solution:

  • Review your configuration file
  • Check for syntax errors
  • Ensure all required fields are present
  • Validate the values against the expected format

CLI-0007

Error Message: Failed to save project

Cause: The system encountered an error when attempting to save project changes.

Solution:

  • Verify you have the correct permissions
  • Check if the project still exists
  • Ensure all project parameters are valid
  • Check the logs for more specific error details

CLI-0008

Error Message: Failed to deploy project

Cause: The system encountered an error when attempting to deploy a project.

Solution:

  • Verify you have the correct permissions
  • Check if the project is valid and complete
  • Ensure all dependencies are available
  • Check the logs for more specific error details

CLI-0009

Error Message: Failed to upload project

Cause: The system encountered an error when attempting to upload project files.

Solution:

  • Check your internet connection
  • Verify you have the correct permissions
  • Ensure the project files are not too large
  • Check the logs for more specific error details

CLI-0010

Error Message: Failed to parse environment file

Cause: The system could not parse the environment file (.env).

Solution:

  • Check the syntax of your environment file
  • Ensure the file exists and is readable
  • Verify the file format is correct
  • Remove any invalid characters or formatting

CLI-0011

Error Message: Invalid command flag error

Cause: One or more command flags provided are invalid or incompatible.

Solution:

  • Check the command documentation
  • Verify the flag names and values
  • Ensure flags are compatible with each other
  • Use the help command for correct usage

CLI-0012

Error Message: Failed to list files and directories

Cause: The system could not list files or directories in the specified location.

Solution:

  • Verify the path exists
  • Check if you have permission to access the location
  • Ensure the path is correctly formatted
  • Check for any file system errors

CLI-0013

Error Message: Failed to write configuration file

Cause: The system could not write to the configuration file.

Solution:

  • Check if you have write permissions
  • Verify the directory exists
  • Ensure there is enough disk space
  • Check if the file is locked by another process

CLI-0014

Error Message: Failed to read configuration file

Cause: The system could not read the configuration file.

Solution:

  • Verify the file exists
  • Check if you have read permissions
  • Ensure the file is not corrupted
  • Check if the file format is correct

CLI-0015

Error Message: Failed to create directory

Cause: The system could not create a directory.

Solution:

  • Check if you have write permissions
  • Verify the parent directory exists
  • Ensure there is enough disk space
  • Check if a file with the same name already exists

CLI-0016

Error Message: Failed to create temporary file

Cause: The system could not create a temporary file.

Solution:

  • Check if you have write permissions to the temp directory
  • Ensure there is enough disk space
  • Verify the temp directory exists
  • Check system temporary file limits

CLI-0017

Error Message: Failed to create zip file

Cause: The system could not create a zip archive.

Solution:

  • Check if you have write permissions
  • Ensure there is enough disk space
  • Verify all files to be zipped exist and are readable
  • Check if the zip utility is installed correctly

CLI-0018

Error Message: Failed to open file

Cause: The system could not open the specified file.

Solution:

  • Verify the file exists
  • Check if you have permission to access the file
  • Ensure the file is not locked by another process
  • Check if the file path is correct

CLI-0019

Error Message: Failed to load templates

Cause: The system could not load the required templates.

Solution:

  • Verify the templates exist
  • Check if you have permission to access the templates
  • Ensure the template format is correct
  • Check if the template path is correct

CLI-0020

Error Message: Failed to authenticate with otel server

Cause: The system could not authenticate with the OpenTelemetry server.

Solution:

  • Verify your OTEL server credentials
  • Check if the OTEL server is running
  • Ensure the OTEL server URL is correct
  • Check your network connection to the OTEL server

CLI-0021

Error Message: Failed to install dependencies

Cause: The system could not install the required dependencies.

Solution:

  • Check your internet connection
  • Verify you have the necessary permissions
  • Ensure the package manager is working correctly
  • Check for conflicts with existing packages

CLI-0022

Error Message: Error importing project

Cause: The system encountered an error when attempting to import a project.

Solution:

  • Verify the project structure is valid
  • Ensure all required files are present
  • Check if the project is compatible with the current CLI version
  • Verify you have the necessary permissions to import the project

CLI-0023

Error Message: Error encrypting deployment zip file

Cause: The system could not encrypt the deployment zip file.

Solution:

  • Check if encryption keys are valid
  • Verify you have the necessary permissions
  • Ensure the zip file was created successfully
  • Check if the encryption library is working correctly

CLI-0024

Error Message: Error adding GitHub Action Workflow to the project

Cause: The system encountered an error when attempting to add a GitHub Action workflow to the project.

Solution:

  • Verify you have write permissions to the repository
  • Check if the .github/workflows directory exists or can be created
  • Ensure the workflow file format is valid
  • Verify your GitHub repository settings allow Actions

CLI-0025

Error Message: Failed to upgrade CLI

Cause: The system could not upgrade the CLI to the latest version.

Solution:

  • Check your internet connection
  • Verify you have write permissions to the CLI installation directory
  • Ensure the upgrade server is accessible
  • Try running the upgrade command with elevated privileges
  • Check if there are any conflicting processes using the CLI

CLI-0026

Error Message: Failed to fetch API keys

Cause: The system could not retrieve API keys from the server.

Solution:

  • Check your internet connection
  • Verify your authentication credentials are valid
  • Ensure you have permission to access API keys
  • Check if the API server is accessible
  • Try refreshing your authentication token

CLI-0027

Error Message: Failed to create API key

Cause: The system could not create a new API key.

Solution:

  • Verify you have permission to create API keys
  • Check if you've reached the maximum number of API keys
  • Ensure the API key name is unique and valid
  • Verify your authentication credentials are current
  • Check the server logs for more specific error details

CLI-0028

Error Message: Failed to delete API key

Cause: The system could not delete the specified API key.

Solution:

  • Verify the API key exists
  • Check if you have permission to delete the API key
  • Ensure the API key is not currently in use
  • Verify your authentication credentials are valid
  • Try refreshing your session and attempting again

Need Help?

Join our DiscordCommunity for assistance or just to hang with other humans building agents.

Send us an email at hi@agentuity.com if you'd like to get in touch.

Please Follow us on

If you haven't already, please Signup for your free account now and start building your first agent!

On this page