archon-claude-trust-resolution

Configure environment variables and validate git setup to resolve nested Claude Code timeouts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/shichiyou/hermes-agent-001 --skill archon-claude-trust-resolution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archon-claude-trust-resolution
Source: https://github.com/shichiyou/hermes-agent-001/tree/main/.devcontainer/hermes-backup/skills/.archive/archon-claude-trust-resolution
Command: npx skills add https://github.com/shichiyou/hermes-agent-001 --skill archon-claude-trust-resolution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Resolving "Query aborted" / "claude.first_event_timeout" errors when Archon workflows run Claude Code in non-interactive environments. Nested Claude Code sessions can deadlock and the default 60-second timeout often leads to abrupt failures, especially in slow or multi-session contexts.

Core Features & Use Cases

  • Extend the first-event timeout by setting ARCHON_CLAUDE_FIRST_EVENT_TIMEOUT_MS (e.g., 120000) before running Archon commands.
  • Suppress the Nested Claude warning when running inside Claude Code to avoid false failure signals in automated pipelines.
  • Validate the launch directory is a valid git repository (has a .git folder and at least one commit) and remove unintended remotes to prevent misalignment.
  • Recommend running from the repository root to adhere to official guidelines and ensure correct worktree behavior.

Quick Start

Navigate to the repository root and run the Archon workflow as described to reproduce the issue and apply the recommended fixes.

Frequently Asked Questions about archon-claude-trust-resolution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Claude Code first_event_timeout errors in Archon workflows?

To resolve Claude Code first_event_timeout errors in Archon workflows, set the ARCHON_CLAUDE_FIRST_EVENT_TIMEOUT_MS environment variable to a higher value like 120000 before running your commands.

Why does Archon abort queries when running nested Claude Code sessions?

Archon aborts queries in nested Claude Code sessions because the default 60-second timeout is often too short, causing deadlocks and abrupt failures in slow or multi-session non-interactive environments.

How do I suppress nested Claude warnings in automated pipelines?

To suppress nested Claude warnings in automated pipelines, set the ARCHON_SUPPRESS_NESTED_CLAUDE_WARNING environment variable to avoid false failure signals when running inside a Claude Code session.

What git repository setup is required for Archon workflows?

Archon workflows require running from a valid git repository root with a .git folder and at least one commit, while removing unintended remotes to prevent worktree misalignment.

Does Archon support non-interactive environments for Claude Code?

Yes, Archon supports non-interactive environments for Claude Code by adjusting environment variables like ARCHON_CLAUDE_FIRST_EVENT_TIMEOUT_MS and suppressing nested warnings to prevent false failures.

What is the recommended timeout setting for Archon Claude Code workflows?

The recommended timeout setting for Archon Claude Code workflows is 120000 milliseconds via ARCHON_CLAUDE_FIRST_EVENT_TIMEOUT_MS, extending the default 60-second limit to prevent deadlocks.