Skip to content

v1.18.0

Choose a tag to compare

@github-actions github-actions released this 03 Apr 22:38
· 2045 commits to main since this release
8a54d9b

v1.18.0 — Agent Builder: Create Your Own Sub-Agents

Highlights

New feature: "Create your own Agent" — a guided 6-step TUI flow that lets you build custom AI sub-agents from natural language descriptions, preview the generated SKILL.md, and install it across all your configured agents in one shot.

How It Works

  1. Select "Create your own Agent" from the Welcome menu
  2. Choose which installed AI engine generates your skill (Claude Code, OpenCode, Gemini CLI, or Codex)
  3. Describe what you want your agent to do in natural language
  4. Optionally configure SDD integration (standalone, phase support, or new pipeline phase)
  5. Preview the generated SKILL.md with full metadata
  6. Install — the skill is deployed to every configured agent automatically

What's New

  • Agent Builder TUI — 8 new screens with full j/k navigation, multi-line textarea input, scrollable preview, and progress indicators
  • Generation EngineGenerationEngine interface wrapping installed AI CLI tools (claude --print, opencode run, gemini -p, codex exec) with stderr capture for clear error messages
  • Cross-Agent Installer — atomic skill writer with rollback on partial failure, deploys to Claude Code, OpenCode, Gemini CLI, Codex, and more
  • Custom Agent Registry — JSON registry at ~/.config/gentle-ai/custom-agents.json with builtin name conflict detection (auto-derives from catalog)
  • SDD Integration — custom agents can support existing SDD phases or add new ones to the pipeline, with marker-based system prompt injection
  • Generation Cancel — Esc cancels in-flight generation via context cancellation
  • skill-registry skill — now deployed to all agents (was missing from OpenCode)

Bug Fixes

  • Fixed: "Configure models" → Claude models → Back would navigate through install flow instead of returning to config menu
  • Fixed: Welcome menu "Create your own Agent" now properly disables when no engine binaries are detected
  • Fixed: Preview screen shows install error message when installation fails
  • Fixed: Registry creates parent directory on first use
  • Fixed: Preview scroll uses arrow keys, j/k navigates action bar (help text updated)

Install / Upgrade

brew upgrade gentle-ai

Or run gentle-ai and select "Upgrade tools".