pikoci / main

01

Single binary

No Docker Compose. No Kubernetes. No setup scripts. Download and run.

02

Grows with you

Start in memory. Add SQLite for persistence. Add Postgres and distributed workers at scale. The tool never changes.

03

Run pipelines locally

The pipeline is the environment. Run it anywhere. pikoci run -p pipeline.hcl -j test runs any job on your laptop — no server, no push, no waiting. Override resources with local paths. Iterate before touching CI.

04

Four pluggable abstractions

Resource types, runners, services, and secret backends. Define once, reuse across jobs. Source any of them from a URL.

05

HCL pipelines

Terraform-style syntax. More expressive than YAML. Readable, reviewable, versionable.

06

Truly portable

Bundle the binary with a pipeline file and SQLite. Move it anywhere. Run it instantly.

resource_type "git" {
  source = "pikoci://git"
}

resource "git" "app" {
  params {
    url  = "https://github.com/myorg/app.git"
    name = "app"
  }
}

job "test" {
  get "git" "app" {
    trigger = true
  }
  task "run-tests" {
    run "docker" {
      image = "golang:1.25"
      cmd   = "cd app && go test ./..."
    }
  }
}

service_type "postgres" {
  start "exec" {
    path = "/bin/sh"
    args = ["-ec", "docker run -d --name pikoci-pg -p 5432:5432 -e POSTGRES_PASSWORD=test postgres:16"]
  }
  ready_check "exec" {
    path     = "/bin/sh"
    args     = ["-ec", "docker exec pikoci-pg pg_isready"]
    interval = "2s"
    timeout  = "30s"
  }
  stop "exec" {
    path = "/bin/sh"
    args = ["-ec", "docker rm -f pikoci-pg"]
  }
}

job "integration" {
  service "postgres" {}

  get "cron" "tick" { trigger = true }
  task "test" {
    run "exec" {
      path = "make"
      args = ["test"]
    }
  }
}

secret_type "env" {
  source = "pikoci://file"
  format = "env"
  path   = "/etc/pikoci/secrets.env"
}

variable "deploy_token" {
  type = string
  secret "env" {
    key = "DEPLOY_TOKEN"
  }
}

resource_type "git" {
  source = "pikoci://git"
}

resource "git" "app" {
  params {
    url   = "https://github.com/myorg/app.git"
    name  = "app"
    token = var.deploy_token
  }
}

job "deploy" {
  get "git" "app" { trigger = true }
  task "push" {
    run "exec" {
      path = "/bin/sh"
      args = ["-c", "cd app && ./deploy.sh"]
    }
  }
}