dandacompany/bluekiwi

IA Agent Workflow Engine**

Проектируйте многоразовые рабочие процессы, запускайте их от любого агента кодирования ИИ и наблюдайте за каждым шагом в режиме реального времени.

Быстрая настройка · Навыки · Системы проектирования · Инструменты MCP · CLI · Самохостинг · Вклад

Presentation Slides · Слайды презентации

Что такое BlueKiwi?

BlueKiwi - это движок рабочего процесса ** для агентов кодирования ИИ**. Вы разрабатываете многошаговые рабочие процессы один раз в веб-интерфейсе, затем любой подключенный агент (Claude Code, Codex CLI, Gemini CLI, …) может начать и выполнить их - с каждым шагом, зарегистрированным в живой временной шкале, которую вы можете смотреть в браузере.

** Больше никаких подсказок для копирования.** Ваши лучшие рабочие процессы становятся многоразовыми институциональными знаниями.

Быстрая настройка

Предпосылки

Обсуждение Docker + Docker Compose

###1.Скачайте файл

###2 Настройка .env

Откройте .env и установите два требуемых значения:

###3 Начать

Откройте http://localhost:3100/setup → создайте учетную запись суперпользователя. Страница /setup доступна только до создания первой учетной записи.

Стек запускает приложение Next.js на порту 3100 (настраивается через APP_PORT), PostgreSQL 16 и Redis 7 — все управляется Docker.

###4 Установите CLI

---

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)