Skip to content
RelKit
Esc
↑↓navigate↵open⌘Jpreview
On this page

Error codes

Every RelKit error and warning code, what it means and what to do next.

Every error and warning RelKit prints starts with a RELKIT_* code and ends with a link to that code’s page. Each page says what happened and what to do next.

Code Problem
RELKIT_ADD_API_UNAVAILABLE Scaffolding support could not be loaded
RELKIT_ADD_CANCELLED relkit add was cancelled
RELKIT_ADD_COLLISION Added code would overwrite existing code
RELKIT_ADD_INSTALLATION_FAILED Dependency installation failed after relkit add
RELKIT_ADD_INVALID_PROJECT Project cannot be extended by relkit add
RELKIT_ADD_UNSUPPORTED_SOURCE_SHAPE Source file is too customized to edit
RELKIT_ADD_USAGE Invalid relkit add arguments
RELKIT_ADD_VALIDATION_FAILED Project check failed after relkit add
RELKIT_AGENT_ACCESS_DENIED Agent tool call was refused
RELKIT_AGENT_CANCELLED Agent run was cancelled
RELKIT_AGENT_CONTROL_INVALID Agent is missing the approve control
RELKIT_AGENT_DEADLINE_INVALID Agent timeout or deadline is invalid
RELKIT_AGENT_INPUT_VALIDATION Agent input is invalid
RELKIT_AGENT_INVOCATION_FAILED Agent run failed
RELKIT_AGENT_JSON_INVALID Agent value is not plain JSON
RELKIT_AGENT_LIMIT_INVALID Agent size limit is invalid
RELKIT_AGENT_MODEL_ERROR Model returned an error
RELKIT_AGENT_MODEL_UNAVAILABLE Agent model is not available
RELKIT_AGENT_OUTPUT_VALIDATION Agent output is invalid
RELKIT_AGENT_RESPONSE_LIMIT Agent value is too large
RELKIT_AGENT_RESUME_UNAVAILABLE No agent run is waiting
RELKIT_AGENT_RUN_FAILED Agent run failed
RELKIT_AGENT_RUN_PENDING Agent thread is waiting for approval
RELKIT_AGENT_STEP_LIMIT Agent hit its step limit
RELKIT_AGENT_TIMEOUT Agent run timed out
RELKIT_AGENT_TOOL_DENIED Agent tool call was denied
RELKIT_AGENT_TOOL_FAILED Agent tool call failed
RELKIT_AGENT_TOOL_INVALID Agent tool is invalid
RELKIT_AGENT_TOOL_LIMIT Agent hit its tool-call limit
RELKIT_AGENT_TOOL_UNKNOWN Agent called an unknown tool
RELKIT_APP_DUPLICATE More than one app config is exported
RELKIT_APPLICATION_BUILD_UNAVAILABLE No build for createRelkit
RELKIT_APPLICATION_NOT_RUNNING No application is running
RELKIT_APPROVAL_DENIED Tool call was denied
RELKIT_APPROVAL_INVALID Approval request is invalid
RELKIT_APPROVAL_REQUIRED Tool call needs approval
RELKIT_APPROVAL_STATE_INVALID Approval cannot change to this state
RELKIT_ARTIFACT_WRITE_FAILED Generated files could not be written
RELKIT_AUTH_DUPLICATE Better Auth is set up more than once