Configuration
Configure how Software Factory connects to Squrl Nest or GitHub, which coding-agent CLI it drives, and how each repo behaves.
Coding-agent backend
Software Factory is an orchestrator, not a coding assistant of its own — the implement stage drives whichever external AI coding-agent CLI you configure. Set this from Settings → Coding Agent in the web UI:
| Backend | Notes |
|---|---|
| Claude Code | Must be installed and reachable from wherever Software Factory is running. |
| Codex | Must be installed and reachable from wherever Software Factory is running. |
| Forage | Squrl Labs' own knowledge-graph-backed coding assistant. |
GitHub access
Each connected repository needs credentials with permission to read/file issues and open pull requests. Configure these per-repo when connecting it from Repositories → Connect in the web UI.
Approval mode
Set per-repo from that repo's settings — Supervised (a human approves every pipeline-stage transition) or Auto (the whole pipeline runs unattended). See Approval Modes for the full comparison.
Web UI port
The web UI listens on port 4287 by default. Configurable via the PORT environment variable (Docker) or a --port flag (single binary).