# Changelog All notable user-visible changes to open-forge are documented here. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: [Semantic Versioning](https://semver.org/spec/v2.0.0.html). --- ## [Unreleased] ## [0.24.0] — 2026-05-03 ### Added - **gstack companion recommendation** — skill now surfaces Grafana + Prometheus + Loki as a recommended observability companion for any deployed app; new monitoring module covers scrape config, dashboards, and alert rules - `references/modules/monitoring.md` — reusable module for attaching metrics/logs collection to any recipe ## [0.23.1] — 2026-05-03 ### Added - `ARCHITECTURE.md` — 200-line walkthrough of the four actors (maintainer, bot, AI sessions, end users), state stores, contribution pipeline, and anti-patterns; cross-linked from README and AGENTS.md - Updated recipe count in README, AGENTS.md, and CLAUDE.md to reflect 950+ → 1,100+ catalog entries ## [0.23.0] — 2026-05-02 ### Added - **Backups module** (`references/modules/backups.md`) — reusable backup patterns for any deployed app: volume snapshots, database dumps, Restic/Backrest, object-storage offload - **Curated deployment bundles** — two recipe-of-recipes bundles for goal-shaped requests: - `references/bundles/ai-homelab.md` — Open WebUI + Ollama + image gen + LLMOps in one deployment - `references/bundles/privacy-stack.md` — Vaultwarden + Nextcloud + Immich + Bitwarden in one deployment ## [0.22.0] — 2026-04-30 ### Added - **Agent-platform support** — skill now ships as a native agent for OpenClaw and Hermes-Agent in addition to Claude Code / Codex / Cursor / Aider / Continue - `dist/openclaw/` and `dist/hermes/` distribution bundles generated by `scripts/build-dist.sh` - `docs/platforms/openclaw.md` and `docs/platforms/hermes.md` — per-platform integration guides ## [0.21.0] — 2026-04-30 ### Added - **Multi-platform distribution** — `scripts/build-dist.sh` generates self-contained bundles for 5 platforms: Codex, Cursor, Aider, Continue, generic - `dist/` directory with platform-specific SKILL.md + system-prompt + bundle variants - CI check (`dist-bundles.yml`) ensures dist/ stays in sync with canonical sources ## [0.20.1] — 2026-04-30 ### Added - **Credential-handling module** (`references/modules/credentials.md`) — five patterns for safely collecting secrets: environment variables, secret managers, Docker secrets, `.env` files, and when to refuse chat paste; copied into both dist/codex and dist/generic bundles at build time ## [0.20.0] — 2026-04-30 ### Added - **Post-deploy feedback flow** — skill automatically drafts a GitHub issue after each deployment asking users to report what worked, what broke, and what the docs missed; issue body includes the combo (infra × runtime) for structured signal collection - **Sanitization module** (`references/modules/feedback.md`) — strips PII from feedback drafts before submission ## [0.19.3] — 2026-04-29 ### Added - **Scope criteria** — explicit "Is this software in scope?" decision tree in CLAUDE.md; Tier 1 (verified, actively maintained, 3+ demand signals) vs Tier 2 (speculative) routing - Graduation criteria for Tier 2 → Tier 1 promotion ## [0.19.2] — 2026-04-29 ### Fixed - Audit-fix wave for six existing recipes (Ollama, Stable Diffusion WebUI, OpenClaw, Open WebUI, Dify, Hermes): removed unverified install flags, corrected port mappings, aligned with upstream README as of verification date ## [0.19.0] — 2026-04-28 ### Added - **Langfuse** (`references/projects/langfuse.md`) — LLM observability, tracing, prompt management, and evaluation platform; Docker Compose + Kubernetes paths ## [0.18.0] — 2026-04-28 ### Added - **vLLM** (`references/projects/vllm.md`) — production-grade LLM inference server with OpenAI-compatible API; GPU and CPU paths, tensor parallelism, quantization options ## [0.17.1] — 2026-04-28 ### Fixed - Removed two upstream-doc hallucinations introduced in v0.17.0 (non-existent Aider `--docker` flag and a fabricated config-file path); corrected to match upstream README ## [0.17.0] — 2026-04-28 ### Added - **Aider** (`references/projects/aider.md`) — AI pair-programming CLI; covers pip install, Docker, and `aider --model` flag patterns across OpenAI / Anthropic / Ollama backends ## [0.16.0] — 2026-04-28 ### Added - **AnythingLLM** (`references/projects/anythingllm.md`) — RAG-focused workspace + agent platform with multi-user support, document ingestion, and vector store backends ## [0.15.1] — 2026-04-28 ### Fixed - Retroactive doc-verification fixes across the initial recipe set (ghost, openclaw, open-webui, dify, librechat, comfyui, a1111): each recipe re-verified against upstream README; fabricated flags and config paths removed; strict-doc policy applied retroactively ## [0.15.0] — 2026-04-28 ### Added - **LibreChat** (`references/projects/librechat.md`) — multi-provider chat UI for teams; covers Docker Compose with MongoDB, env config for OpenAI / Anthropic / Azure / Ollama backends ## [0.14.0] — 2026-04-28 ### Added - **Dify** (`references/projects/dify.md`) — LLMOps + AI app builder platform; Docker Compose (12-service canonical path), Kubernetes via community Helm, Terraform cloud templates ## [0.13.0] — 2026-04-27 ### Added - **ComfyUI** (`references/projects/comfyui.md`) — node-based AI image and video generation; GPU (CUDA) and CPU paths, model directory layout, custom-nodes install ## [0.12.0] — 2026-04-27 ### Added - **Stable Diffusion WebUI** (`references/projects/stable-diffusion-webui.md`) — Automatic1111 / A1111; GPU and CPU paths, `--listen` flag, model directory, xformers ## [0.11.0] — 2026-04-27 ### Added - **Open WebUI** (`references/projects/open-webui.md`) — multi-user web interface for any OpenAI-compatible LLM; Ollama integration, multi-user auth, Docker Compose path ## [0.10.0] — 2026-04-27 ### Added - **Ollama** (`references/projects/ollama.md`) — local-LLM inference server; GPU (CUDA/ROCm) and CPU paths, model pull, OpenAI-compat API; foundation layer for the AI homelab stack ## [0.9.0] — 2026-04-27 ### Added - **Hermes-Agent** (`references/projects/hermes.md`) — Nous Research Hermes model deployment; covers API server path and integration with Open WebUI ## [0.8.0] — 2026-04-26 ### Added - All three official OpenClaw deployment methods verified against docs.openclaw.ai/install/*: Docker Compose on VPS, native install, managed cloud ## [0.7.0] — 2026-04-26 ### Added - **Kubernetes / Helm path** for OpenClaw — Helm chart values, Ingress, PVC, and namespace setup; covers the last upstream-blessed install path ## [0.6.0] — 2026-04-26 ### Added - OpenClaw combo gaps closed: EC2 + Hetzner + DigitalOcean + GCP infra adapters; native-binary runtime module ## [0.5.0] — 2026-04-24 ### Changed - Slimmed openclaw recipe; combo-aware preflight; SKILL.md and README refresh ## [0.4.0] — 2026-04-23 ### Added - **OpenClaw Path C** — Docker container on any Linux VPS recipe ## [0.3.0] — 2026-04-23 ### Added - **Preflight module** — per-recipe input prompts collect all required values before any infra action; input schema now part of every recipe ## [0.2.0] — 2026-04-23 ### Added - **OpenClaw on Lightsail** recipe — first non-Ghost deployment target ## [0.1.0] — 2026-04-22 ### Added - Initial release: **Ghost on Lightsail** recipe — the first Tier 1 verified recipe - Core skill scaffolding: `SKILL.md`, `references/` directory structure, infra adapter pattern --- [Unreleased]: https://github.com/zhangqi444/open-forge/compare/v0.24.0...HEAD [0.24.0]: https://github.com/zhangqi444/open-forge/compare/v0.23.1...v0.24.0 [0.23.1]: https://github.com/zhangqi444/open-forge/compare/v0.23.0...v0.23.1 [0.23.0]: https://github.com/zhangqi444/open-forge/compare/v0.22.0...v0.23.0 [0.22.0]: https://github.com/zhangqi444/open-forge/compare/v0.21.0...v0.22.0 [0.21.0]: https://github.com/zhangqi444/open-forge/compare/v0.20.1...v0.21.0 [0.20.1]: https://github.com/zhangqi444/open-forge/compare/v0.20.0...v0.20.1 [0.20.0]: https://github.com/zhangqi444/open-forge/compare/v0.19.3...v0.20.0 [0.19.3]: https://github.com/zhangqi444/open-forge/compare/v0.19.2...v0.19.3 [0.19.2]: https://github.com/zhangqi444/open-forge/compare/v0.19.0...v0.19.2 [0.19.0]: https://github.com/zhangqi444/open-forge/compare/v0.18.0...v0.19.0 [0.18.0]: https://github.com/zhangqi444/open-forge/compare/v0.17.1...v0.18.0 [0.17.1]: https://github.com/zhangqi444/open-forge/compare/v0.17.0...v0.17.1 [0.17.0]: https://github.com/zhangqi444/open-forge/compare/v0.16.0...v0.17.0 [0.16.0]: https://github.com/zhangqi444/open-forge/compare/v0.15.1...v0.16.0 [0.15.1]: https://github.com/zhangqi444/open-forge/compare/v0.15.0...v0.15.1 [0.15.0]: https://github.com/zhangqi444/open-forge/compare/v0.14.0...v0.15.0 [0.14.0]: https://github.com/zhangqi444/open-forge/compare/v0.13.0...v0.14.0 [0.13.0]: https://github.com/zhangqi444/open-forge/compare/v0.12.0...v0.13.0 [0.12.0]: https://github.com/zhangqi444/open-forge/compare/v0.11.0...v0.12.0 [0.11.0]: https://github.com/zhangqi444/open-forge/compare/v0.10.0...v0.11.0 [0.10.0]: https://github.com/zhangqi444/open-forge/compare/v0.9.0...v0.10.0 [0.9.0]: https://github.com/zhangqi444/open-forge/compare/v0.8.0...v0.9.0 [0.8.0]: https://github.com/zhangqi444/open-forge/compare/v0.7.0...v0.8.0 [0.7.0]: https://github.com/zhangqi444/open-forge/compare/v0.6.0...v0.7.0 [0.6.0]: https://github.com/zhangqi444/open-forge/compare/v0.5.0...v0.6.0 [0.5.0]: https://github.com/zhangqi444/open-forge/compare/v0.4.0...v0.5.0 [0.4.0]: https://github.com/zhangqi444/open-forge/compare/v0.3.0...v0.4.0 [0.3.0]: https://github.com/zhangqi444/open-forge/compare/v0.2.0...v0.3.0 [0.2.0]: https://github.com/zhangqi444/open-forge/compare/v0.1.0...v0.2.0 [0.1.0]: https://github.com/zhangqi444/open-forge/releases/tag/v0.1.0