Error Reference
Gitquarry returns one clear error at a time.Common Error Codes
E_AUTH_REQUIRED
No effective credential was available for the current host.
Typical fix:
E_AUTH_INVALID
The token was empty, rejected, or invalid for the attempted operation.
E_AUTH_STORAGE
Credential storage failed.
Common causes:
- local secure storage backend unavailable
- insecure fallback not explicitly enabled
- malformed insecure credential file
E_FLAG_PARSE
Clap-level flag parse failure, such as an invalid enum value.
E_FLAG_CONFLICT
Two flags or inputs conflict semantically.
Examples:
- mixed date-window styles
- invalid blended weights
- raw qualifier plus overlapping structured flag
E_FLAG_REQUIRES_MODE
A flag requires --mode discover.
Typical examples:
- non-native
--rank - discovery-only
--depth - advanced enrichment knobs
E_QUERY_REQUIRED
A plain native search was attempted without a query.
E_GITHUB_API
GitHub returned a non-success API response that gitquarry could not treat as a normal optional case.
E_HTTP
Transport, request, or decode failure.
E_CONFIG_PATH
Gitquarry could not determine the user config directory.
E_CONFIG_IO
Config or config-directory I/O failed.
E_CONFIG_PARSE
config.toml existed but could not be parsed.
E_HOST_INVALID
The --host value was empty or malformed.