Architect CLI: Open-source tool for orchestrating headless AI coding agents in CI/CD

What Architect CLI does

Architect is an open-source CLI tool built specifically for orchestrating headless AI coding agents in CI/CD environments. It addresses the problem that while AI agents can generate code, there's typically no guarantee the generated code actually works when running unsupervised in pipelines.

Key features from the source

• Ralph Loop: Runs your code, tests it, and if it fails, retries with clean context. This can continue for hours if needed.
• Deterministic guardrails: Includes protected files, blocked commands, and quality gates that the LLM cannot bypass.
• YAML pipelines: Agent workflows are defined as code using YAML configuration.
• Any LLM support: Works with Claude, GPT, DeepSeek, Ollama, and other LLMs via LiteLLM integration. The tool's guarantees remain consistent regardless of which LLM is used.

Design philosophy

The tool is described as "headless-first" and "CI/CD-native," with a focus on verification layers. The creator emphasizes that Architect doesn't compete with interactive tools like Claude Code, Cursor, or Copilot, but rather collaborates with them. The analogy provided is "the difference between the pilot and air traffic control."

Availability and development

Architect is being built with the help of Claude Code, and the creator is seeking feedback from developers running or considering AI agents in CI/CD. The project is available on GitHub with accompanying documentation.