v1.18.0
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
- Select "Create your own Agent" from the Welcome menu
- Choose which installed AI engine generates your skill (Claude Code, OpenCode, Gemini CLI, or Codex)
- Describe what you want your agent to do in natural language
- Optionally configure SDD integration (standalone, phase support, or new pipeline phase)
- Preview the generated SKILL.md with full metadata
- 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 Engine —
GenerationEngineinterface 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.jsonwith 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".