@every-env/cli/TIMEOUT_CONFIGURATION.md

Multi-agent orchestrator for AI-powered development workflows

# Timeout Configuration

As of version 0.5.13, @every-env/cli has a default timeout of **2 hours** for all agent processes.

## Configuration Options

You can configure the timeout in several ways (in order of priority):

### 1. Command Line Option
```bash
# Set timeout to 30 minutes
every-env plan "my feature" --timeout 1800000

# Set timeout to 3 hours
every-env plan "complex analysis" --timeout 10800000
```

### 2. Environment Variable
```bash
# Set timeout to 4 hours for all commands
export EVERY_ENV_TIMEOUT=14400000
every-env plan "my feature"
```

### 3. Agent Configuration
In your `.every-env/config.json` or `.docs-config.json`:
```json
{
  "agents": [{
    "id": "my-agent",
    "timeout": 3600000,  // 1 hour for this specific agent
    "command": "claude",
    "promptFile": "my-prompt.md"
  }]
}
```

### 4. Default
If no timeout is specified, the default is **7200000ms (2 hours)**.

## Common Timeout Values

- 30 minutes: `1800000`
- 1 hour: `3600000`
- 2 hours: `7200000` (default)
- 3 hours: `10800000`
- 4 hours: `14400000`

## Troubleshooting

If you're still getting timeout errors:
1. Check that you're using version 0.5.13 or later: `every-env --version`
2. Try setting a longer timeout using one of the methods above
3. Check if your agent process is actually hanging (infinite loop, waiting for input, etc.)