Skip to content

KiCI documentation

KiCI is a complete CI/CD system that runs your pipelines on machines you control. The hosted platform relays webhooks and renders the dashboard without ever seeing your source or secrets — your own orchestrator and agents clone the code, run the jobs, and hold the logs. You and your coding agent get the full dev loop on that infrastructure: compile, run your working tree on your own agents, push, then read and re-run the result.

New to KiCI? Follow these in order:

  1. Green run in ~5 minutes — stand up an orchestrator and agent (Docker / Podman or bare metal) and watch your first workflow go green.
  2. Getting started — install the SDK, write your first workflow, compile it, and test it locally.
  3. Why KiCI — the case for a complete CI/CD system on your own infrastructure, with a dev loop your coding agent can own.
  4. GitHub App provider — connect your first source and route real events.
  • User guide — write, test, and ship CI/CD workflows in TypeScript: the SDK, workflow patterns, providers, the dashboard, secrets, and contexts.
  • Operator guide — deploy and run the orchestrator and agents on your own infrastructure: configuration, the auto-scaler, Firecracker, clustering, security, and observability.
  • Architecture — the three-tier relay model, execution lifecycle, protocol messages, webhook pipeline, and design decisions.

The left sidebar is the full index — every page, grouped by audience.