Skip to content

v0.20.0

Choose a tag to compare

View all tags
@snonux snonux released this 14 Feb 20:54
· 331 commits to main since this release
v0.20.0
84c8361

Release v0.20.0

Release Notes

Overview

This release introduces hexai-mcp-server, a new MCP (Model Context Protocol) server for managing reusable prompts and runbooks. AI agents like Claude Code CLI, Cursor, and Amp can now discover and use your prompt library through the industry-standard MCP protocol. The release also includes built-in meta-prompts for interactive prompt management, automatic backups, and comprehensive documentation.

✨ Features

MCP Server for Prompt Management (hexai-mcp-server)

A new standalone binary that lets any MCP-compatible AI agent access your prompt library over stdio:

  • Full CRUD operations — create, update, delete, and retrieve prompts via standard MCP protocol methods
  • Automatic backups — every prompt change creates a backup (last 10 retained), so you never lose work
  • Built-in meta-prompts — includes create_prompt, update_prompt, and delete_prompt prompts that guide agents through prompt management interactively
  • JSONL storage — prompts are stored in a human-readable, git-friendly format at ~/.local/hexai/data/prompts/user.jsonl
  • Built-in prompt library — ships with useful defaults (code review, explain code, generate tests, simplify code, and more) compiled into the binary
  • MCP Tools support — exposes create_prompt, update_prompt, delete_prompt, list_prompts, and get_prompt as MCP tools for programmatic access

Agent Integration

Works out of the box with popular AI coding tools:

  • Claude Code CLI — add to ~/.config/claude/mcp.json
  • Cursor — add to ~/.cursor/mcp.json
  • Any MCP-compatible client — standard stdio transport

Configurable Prompts Directory

Store prompts wherever makes sense for your workflow:

  • --prompts-dir flag, HEXAI_MCP_PROMPTS_DIR env var, or mcp_prompts_dir in config
  • Use a shared/synced folder for team prompt libraries
  • Use project-local directories for project-specific prompts

📖 Documentation

🔧 Improvements

  • Consolidated local paths — cache, state, and data directories now live under ~/.local/hexai/ for cleaner organization
  • Build system — Magefile updated with BuildHexaiMCPServer target; mage build and mage install now include the MCP server
  • Test coverage — comprehensive tests for MCP server, prompt store, and transport layers

⚠️ Migration Notes

Path Changes

Local storage paths have been consolidated:

Purpose Old Path New Path
Cache ~/.cache/hexai/ ~/.local/hexai/cache/
State & Logs ~/.local/state/hexai/ ~/.local/hexai/state/
Data (prompts) — ~/.local/hexai/data/

If you have existing cache or state files, they should be moved to the new locations.

Installation

Build and install the new binary:

mage build install
# or directly:
go install codeberg.org/snonux/hexai/cmd/hexai-mcp-server@latest
Assets 2
Loading