Authentication failed for ${projectPath}. Check GITLAB_TOKEN

Error message

Authentication failed for ${projectPath}. Check GITLAB_TOKEN permissions.

What it means

Error "Authentication failed for ${projectPath}. Check GITLAB_TOKEN permissions." thrown in coleam00/Archon.

Source

Thrown at packages/adapters/src/community/forge/gitlab/adapter.ts:513

        sanitizedError.cause = sanitize((err.cause as Error).message);
      }
      const errRecord = err as unknown as Record<string, unknown>;
      if (typeof errRecord.stdout === 'string') sanitizedError.stdout = sanitize(errRecord.stdout);
      if (typeof errRecord.stderr === 'string') sanitizedError.stderr = sanitize(errRecord.stderr);

      getLog().error({ projectPath, repoPath, error: sanitizedError }, 'gitlab.repo_clone_failed');

      if (msg.includes('not found') || msg.includes('404')) {
        throw new Error(
          `Repository ${projectPath} not found or is private. Check repository access.`
        );
      }
      if (
        msg.includes('authentication failed') ||
        msg.includes('could not read') ||
        msg.includes('403')
      ) {
        throw new Error(
          `Authentication failed for ${projectPath}. Check GITLAB_TOKEN permissions.`
        );
      }
      throw new Error(`Failed to clone ${projectPath}: ${sanitized}`);
    }

    await addSafeDirectory(toRepoPath(repoPath));
  }

  private async autoDetectAndLoadCommands(repoPath: string, codebaseId: string): Promise<void> {
    const commandFolders = getCommandFolderSearchPaths();

    for (const folder of commandFolders) {
      try {
        const fullPath = join(repoPath, folder);
        await access(fullPath);

        const files = (await readdir(fullPath)).filter(f => f.endsWith('.md'));

View on GitHub (pinned to 0773b97458)

When it happens

Trigger: Thrown at packages/adapters/src/community/forge/gitlab/adapter.ts:513 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

Authentication and authorization failures — expired tokens, bad credentials, and missing scopes.

AI-assisted analysis of coleam00/Archon@0773b97458 (2026-09-01). Data as JSON: /api/errors/b7efbe7b20815aa0. Report an issue: GitHub.