CLI Errors

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