Skip to content

Quickstart

After installing Kube Foundry and creating your credentials secret, you can submit your first task.

Submit a task

Create a file called task.yaml:

apiVersion: factory.factory.io/v1alpha1
kind: SoftwareTask
metadata:
  name: add-login-page
spec:
  repo: https://github.com/yourorg/yourapp
  branch: main
  task: "Add a login page with email/password auth"
  credentials:
    secretRef: factory-creds

Apply it:

kubectl apply -f task.yaml

Watch it work

kubectl get st -w                          # watch status transitions
kubectl logs -f pod/add-login-page-sandbox # watch agent output

The task will progress through phases: Pending → Running → Completed.

Check the result

When the task completes, a PR will appear on your repo:

kubectl get st add-login-page -o jsonpath='{.status.pullRequestURL}'

Using a different agent

By default, tasks use Claude Code. To use Codex or OpenCode:

spec:
  agent: codex       # or: open-code
  credentials:
    secretRef: factory-creds  # must contain OPENAI_API_KEY for codex

Using the REST API

You can also submit tasks via HTTP:

curl -X POST http://<webhook-service>/api/v1/tasks \
  -H "Content-Type: application/json" \
  -d '{
    "repo": "https://github.com/yourorg/yourapp",
    "task": "Add dark mode support"
  }'

Next steps