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