examples

Kelos Orchestration Examples

Ready-to-use patterns and YAML manifests for orchestrating AI agents with Kelos. These examples demonstrate how to combine Tasks, Workspaces, and TaskSpawners into functional AI workflows.

Prerequisites

• Kubernetes cluster (1.28+) with Kelos installed (kelos install)
• kubectl configured

Examples

Example	Description
01-simple-task	Run a single Task with an API key, no git workspace
02-task-with-workspace	Run a Task that clones a git repo and can create PRs
03-taskspawner-github-issues	Automatically create Tasks from labeled GitHub issues
04-taskspawner-cron	Run agent tasks on a cron schedule
05-task-with-agentconfig	Inject reusable instructions and plugins via AgentConfig
06-fork-workflow	Discover upstream issues and work in a fork
07-task-pipeline	Chain Tasks with dependsOn and pass results between stages
08-task-with-kelos-skill	Give an agent the Kelos skill for authoring and debugging resources
09-bedrock-credentials	Run an agent using AWS Bedrock with static credentials or IRSA
10-taskspawner-github-webhook	Respond to GitHub webhook events (issues, PRs, pushes) in real time
11-taskspawner-linear-webhook	Respond to Linear webhook events (issues, comments) in real time
12-taskspawner-file-patterns	Filter GitHub PR / push webhooks by changed-file glob patterns
13-taskspawner-generic-webhook	Respond to arbitrary HTTP POST events (Sentry, Notion, Slack, etc.) using JSONPath field mapping and filters
14-task-budget	Set observed-spend admission limits for matching Tasks
15-workerpool	Run Tasks on pre-warmed WorkerPool pods instead of creating per-task Jobs
16-session	Keep one interactive Claude Code, Codex, or OpenCode conversation across web and terminal chat
17-taskspawner-ci-remediation	Auto-fix failing CI checks via check_run webhooks, filtered by conclusion and check name
18-webhookgateway	Authenticate and route webhook deliveries through named gateways, including multiple GitHub instances

Additional Guides

Guide	Description
webhook-concurrency.md	How maxConcurrency works for webhook TaskSpawners — drop semantics, monitoring, and troubleshooting
gateway-api-webhook.md	Configure Kelos webhook servers using Gateway API instead of Ingress (Istio, Envoy, Kong, Nginx)

How to Use

1. Pick an example directory.
2. Read its README.md for context.
3. Edit the YAML files and replace every # TODO: placeholder with your real values.
4. Apply the resources:

kubectl apply -f examples/<example-directory>/

5. Watch the Task progress:

kubectl get tasks -w

Tips

• Secrets first — always create Secrets before the resources that reference them.
• Namespace — all examples use the default namespace. Change metadata.namespace if you use a different one.
• Cleanup — delete resources with kubectl delete -f examples/<example-directory>/. Owner references ensure that deleting a Task also cleans up its Job and Pod.