.env.template

# .env.template — Autonomous Coding Agent Configuration
# ======================================================
# Copy this to .env and fill in your values, OR run:
#   python acaps.py --configure
# to auto-detect your stack and generate .env from prompts/.

# =============================================================================
# AI Settings
# =============================================================================

# Claude model for the main coding agents
# Default: claude-sonnet-4-6
CLAUDE_MODEL=claude-sonnet-4-6

# Claude model for the --configure detection agent (fast/cheap)
# Default: claude-haiku-4-5-20251001
CONFIGURE_MODEL=claude-haiku-4-5-20251001

# Maximum agent turns per session
# Default: 1000
MAX_TURNS=1000

# Seconds to wait before automatically starting the next session
# Default: 3
AUTO_CONTINUE_DELAY_SECONDS=3

# System prompt injected into every coding agent session.
# Keep to a single line. Tailor to your stack for best results.
# Default: "You are an expert full-stack developer building a production-quality web application."
AGENT_SYSTEM_PROMPT=You are an expert full-stack developer building a production-quality web application.

# =============================================================================
# Tech Stack
# =============================================================================

# Primary backend framework.
# Options: laravel, django, fastapi, rails, flask, generic
# Default: generic
FRAMEWORK=generic

# Package manager(s). Use + to combine (e.g. composer+npm for Laravel with React frontend).
# Options: npm, bun, yarn, pnpm, pip, composer, cargo, go
# Default: npm
PACKAGE_MANAGER=npm

# Command the agent uses to start the dev server inside the project directory.
# Default: npm run dev
DEV_SERVER_CMD=npm run dev

# Port the dev server listens on (used to construct the URL for browser testing).
# Default: 3000
DEV_SERVER_PORT=3000

# =============================================================================
# Security Extensions
# =============================================================================

# Additional bash commands to allow beyond the auto-detected set.
# Comma-separated. Example: make,cmake,rustfmt
# Default: (empty — only auto-detected commands are allowed)
EXTRA_ALLOWED_COMMANDS=

# Additional process names to allow in pkill commands.
# Comma-separated. Example: gunicorn,redis-server
# Default: (empty — only auto-detected processes are allowed)
EXTRA_ALLOWED_PROCESSES=

# =============================================================================
# File Names
# =============================================================================

# Name of the JSON file tracking feature/test completion.
# Default: feature_list.json
FEATURE_LIST_FILE=feature_list.json

# Name of the initialization script the agent generates and runs.
# Default: init.sh
INIT_SCRIPT_NAME=init.sh

# Name of the app specification file copied into the project directory.
# Default: app-spec.txt
APP_SPEC_FILENAME=app-spec.txt

# Name of the Claude settings file written into the project directory.
# Default: .claude_settings.json
SETTINGS_FILENAME=.claude_settings.json

# =============================================================================
# Prompt Files
# =============================================================================

# Prefix for generated project directories (relative to script location).
# Default: generations/
PROJECT_DIR_PREFIX=generations/

# Directory containing prompt template files.
# Default: prompts
PROMPTS_DIR=prompts

# Filename (without .md) of the initializer agent prompt.
# Default: initializer_prompt
INITIALIZER_PROMPT_NAME=initializer_prompt

# Filename (without .md) of the coding agent prompt.
# Default: coding_prompt
CODING_PROMPT_NAME=coding_prompt

# =============================================================================
# Agent CLI Provider
# =============================================================================

# CLI provider used by the harness.
# Options: claude, codex, omp, opencode
# Default: claude
AGENT_CLI_ID=claude

# Provider binaries (override if executable names differ on your machine)
AGENT_CLI_BIN_CLAUDE=claude
AGENT_CLI_BIN_CODEX=codex
AGENT_CLI_BIN_OMP=omp
AGENT_CLI_BIN_OPENCODE=opencode

# Provider-specific model defaults used when --model is not passed
AGENT_CLI_MODEL_CLAUDE=claude-sonnet-4-6
AGENT_CLI_MODEL_CODEX=gpt-5-codex
AGENT_CLI_MODEL_OMP=claude-sonnet-4-5
AGENT_CLI_MODEL_OPENCODE=claude-sonnet-4-5

# Print warnings when the selected provider lacks native feature parity
# (system prompt/tool/sandbox flags may be shimmed in prompt text)
AGENT_CLI_WARN_ON_DEGRADED_CAPS=true

# Require strict JSON-only output contracts for prompt/configure phases
AGENT_CLI_REQUIRE_JSON_OUTPUT=true

# Force third-party providers to run in non-interactive mode where supported
AGENT_CLI_NON_INTERACTIVE=true

# If safe non-interactive mode blocks, retry with stronger auto-approval behavior
AGENT_CLI_AUTO_APPROVE_FALLBACK=true

# Allow dangerous no-approval fallback for autonomous runs (high risk)
AGENT_CLI_DANGEROUS_FALLBACK=true

# Append an autonomy contract to generated coding prompts to avoid blocking workflows
PROMPT_AUTONOMY_OVERRIDE=true

# Persist per-run TUI + handoff output in structured JSONL files
# Default: true
AGENT_RUN_LOGGING_ENABLED=true

# Directory for run logs (relative to repo root unless absolute path)
# Default: logs
AGENT_RUN_LOG_DIR=logs