Cherry Phoenix Application

Autonomous AI development orchestrator built with Phoenix/Elixir.

Setup

mix setup              # Install dependencies and create database
mix phx.server         # Start server at localhost:4000

Development

iex -S mix phx.server  # Start with interactive shell
mix test               # Run unit/integration tests
mix precommit          # Run all checks (format, compile warnings, tests)

E2E Browser Tests

cd e2e
npm install            # First time setup
npm test               # Run all Playwright tests
npm run test:headed    # Run with visible browser
npm run test:ui        # Run with Playwright UI
npx playwright test --project=hello-world      # Hello world pipeline
npx playwright test --project=agent-lifecycle  # Agent lifecycle

Loading Specs

Specs can be loaded via IEx:

kdl = """
project "my-project" version="1.0.0" {
  phases {
    phase id="p1" name="Setup" {
      tasks {
        task id="t1" name="Init" type="implement" {
          description "Initialize the project"
        }
      }
    }
  }
}
"""

{:ok, spec} = Cherry.Specs.Loader.load(kdl)

Kubernetes Deployment

For local k3d development:

• See docs/k8s/k3d.md for setup guide
• See helm/cherry/README.md for Helm chart configuration

For production deployment:

• See docs/k8s/production.md for deployment guide

Architecture

See CLAUDE.md for detailed architecture documentation and AGENTS.md for Phoenix/Elixir guidelines.