dandacompany/bluekiwi

---

What is BlueKiwi?

BlueKiwi is a self-hosted workflow engine for AI coding agents. You design multi-step workflows once in the web UI, then any connected agent (Claude Code, Codex CLI, Gemini CLI, …) can start and execute them — with every step logged in a live timeline you can watch in the browser.

You type:  /bk-start "backend code review"

Agent ──▶ BlueKiwi MCP ──▶ BlueKiwi Server ──▶ Web UI (live timeline)
          list_workflows      stores logs          your browser
          start_workflow      enforces RBAC        comments / approvals
          execute_step        saves outputs
          advance

No more copy-pasting prompts. Your best agent workflows become reusable institutional knowledge.

---

Quick Setup

Prerequisites

• Docker + Docker Compose

1. Download the compose file

mkdir bluekiwi && cd bluekiwi
curl -L https://raw.githubusercontent.com/dandacompany/bluekiwi/main/docker-compose.yml -o docker-compose.yml
curl -L https://raw.githubusercontent.com/dandacompany/bluekiwi/main/.env.example -o .env

2. Configure .env

Open .env and set the two required values:

# Generate with: openssl rand -hex 16
DB_PASSWORD=your_strong_password

# Generate with: openssl rand -hex 32
JWT_SECRET=your_jwt_secret

3. Start

docker compose up -d

Open http://localhost:3100/setup → create your superuser account. The /setup page is only available until the first account is created.

The stack runs the Next.js app on port 3100 (configurable via APP_PORT), PostgreSQL 16, and Redis 7 — all managed by Docker.

4. Install the CLI

npm install -g bluekiwi

Option A — accept an invite (recommended for new team members)

Create an invite in Settings → Team, then:

bluekiwi accept  --server http://localhost:3100

Validates the invite → creates your account → issues an API key → detects installed agent runtimes → injects the BlueKiwi MCP server + skills into each one.

Option B — init with an existing API key (superuser / admin)