Skip to content

Releases

gydnc v0.0.3

Choose a tag to compare

@github-actions github-actions released this 15 Dec 07:51

Release v0.0.3 - December 15, 2025

📊 Release Statistics

  • 6 commits from 1 contributor
  • Released on December 15, 2025

Key Highlights

This release introduces MCP (Model Context Protocol) server support, enabling AI agents to interact with gydnc through standardized MCP tool calls. We've also improved developer experience with better CLI guidance, cleaner documentation, and installation script fixes.

✨ Features

🚀 MCP Server Support

  • New mcp-server command: Run gydnc as a Model Context Protocol server over stdio, allowing AI agents to interact with the guidance knowledge base through standardized MCP tool calls. (caf8105)
    • Exposes gydnc_read tool for listing and retrieving guidance entities
    • Exposes gydnc_write tool for creating and updating guidance entities
    • Supports both list/get operations (read) and create/update operations (write)
    • Includes comprehensive integration tests for all MCP operations

📚 Enhanced Developer Experience

  • New gydnc llm command: Provides standardized interaction protocol documentation for LLMs working with gydnc, improving AI agent integration. (e56ccb9)
  • Improved Cursor rule guidance: Updated interaction framework rules to better guide AI agents in using gydnc effectively. (e56ccb9)

🐛 Bug Fixes

  • Installation script fixes: Resolved issues in the install.sh script for more reliable binary installation. (5d62fd6)

🔧 Improvements

  • Documentation cleanup: Streamlined gydnc guidance to be more concise and actionable, removing unnecessary verbosity. (c4533e8)
  • Configuration path handling: Enhanced GetEffectiveConfigPath to automatically append config.yml when a directory path is provided, improving usability. (caf8105)
  • Cursor rule organization: Cleaned up rule structure and temporary file location guidance for better maintainability. (2fb1e9b)

🎯 What's Next

The MCP server support opens up new possibilities for AI agent integration. Agents can now discover, retrieve, and manage guidance through the standardized MCP protocol, making gydnc more accessible to AI-powered development workflows.

Quick Start

Using the CLI

# Initialize a guidance repository
mkdir my-guidance && cd my-guidance
gydnc init .

# Set configuration
export GYDNC_CONFIG="$(pwd)/.gydnc/config.yml"

# Create guidance
echo "# Safety Guidelines\nValidate all inputs." | \
  gydnc create must/safety-first --title "Safety First" \
  --tags "quality:safety"

# List and retrieve guidance
gydnc list
gydnc get must/safety-first

Using the MCP Server

# Run gydnc as an MCP server (communicates via JSON-RPC over stdio)
gydnc mcp-server

# The server exposes two tools:
# - gydnc_read: List and retrieve guidance entities
# - gydnc_write: Create and update guidance entities

For AI Agents

# Get interaction protocol documentation
gydnc llm

Download

Download the latest release for your platform:

Verification: SHA256 checksums are available in the GitHub release page.

Full Changelog

  • b58d0a5 - Remove dead code in handleCreateOperation
  • caf8105 - gydnc mcp-server, support core operations via MCP
  • c4533e8 - Keep gydnc concise
  • e56ccb9 - Improve Cursor rule + gydnc llm command
  • 2fb1e9b - Clean up Rule and tmp file location
  • 5d62fd6 - Fix install.sh script

Note: The filesystem backend works well with Git for version control, but Git is not required. All guidance is stored as human-readable Markdown files with YAML frontmatter.

gydnc v0.0.2

Choose a tag to compare

@github-actions github-actions released this 25 May 00:24

Release v0.0.2 - $(date +%Y-%m-%d)

Key Highlights

This release focuses on improving test capabilities, multi-backend support, logging enhancements, and build fixes.

✨ Features

  • Enhanced Testing: Introduced a NOT_CONTAINS matcher for more flexible negative assertions in tests. (db4acdd)
  • Improved Version Command: Enhanced the version command and --version flag for better usability. (5ca44fb)

🐛 Bug Fixes

  • Multi-backend Support: Addressed issues and improved reliability for multi-backend configurations. (Primarily fc0a3a7, with related test updates in 006916b)
  • Logging Refinements: Converted filename output in logs to debug level for cleaner default output (and so AI doesn't skip using the cli). (e7e1105)
  • Installation Script Fix: Updated installation scripts for raw binary downloads and added SHA256 checksum verification. (7905467, 5cc02ba)
  • Build Fixes: Resolved golangci-lint warnings for improved code quality. (006916b)

🔧 Improvements

  • Cursor Rule Update: Guidance for Cursor interaction updated to reflect the removal of the --json parameter from gydnc list. (006916b)
  • Code Refactoring & Cleanups: Various internal code improvements for stability and maintainability. (fc0a3a7)
  • Dependency Cleanup: Removed unused Google UUID dependency. (404238f)

Quick Start

# Initialize a guidance repository
mkdir my-guidance && cd my-guidance
gydnc init .

# Set configuration
export GYDNC_CONFIG="$(pwd)/.gydnc/config.yml"

# Create guidance
echo "# Safety Guidelines\nValidate all inputs." | \
  gydnc create must/safety-first --title "Safety First" \
  --tags "quality:safety"

# List and retrieve guidance
gydnc list
gydnc get must/safety-first

Note: The filesystem backend works well with Git for version control, but Git is not required.

gydnc v0.0.1

Choose a tag to compare

@github-actions github-actions released this 24 May 05:25

gydnc v0.0.1

Release Information

  • 20 commits from 1 contributor
  • Released on May 23, 2025
  • Initial public release

About gydnc

gydnc (pronounced "guidance") is a command-line tool for managing structured guidance documents for AI agents. It provides a way to create, organize, and retrieve guidance documents that can be used to instruct AI systems.

Why gydnc?

Share AI Instructions Across Projects

Traditional AI configuration (like .cursorrules files) is tied to individual projects. gydnc allows you to:

  • Centralize guidance: Create shared repositories of AI instructions
  • Reuse across projects: Apply the same safety requirements, coding standards, and workflows to multiple codebases
  • Version control guidance: Track changes to your AI instructions over time
  • Collaborate on prompts: Share effective AI guidance patterns with team members

Practical Use Cases

  • Migrate from .cursorrules: Convert project-specific AI rules into reusable guidance entities
  • Maintain consistency: Ensure AI assistants follow the same safety and quality standards across all your projects
  • Build guidance libraries: Create hierarchical collections like must/safety-first (mandatory rules) and should/code-style (recommendations)
  • Cross-repository workflows: Use the same release processes, testing standards, and development practices everywhere

Example Configuration

# ~/.gydnc/config.yml - Share guidance across multiple projects
storage_backends:
    shared_guidance:
        type: localfs
        localfs:
            path: /path/to/shared-guidance/.gydnc
    project_specific:
        type: localfs
        localfs:
            path: /path/to/current-project/.gydnc

Replace Complex Cursor Rules with One Simple Rule

Instead of maintaining lengthy .cursorrules files in every project, you can use gydnc as your only cursor rule:

.cursor/rules/gydnc.mdc - Your only cursor rule

This approach gives you:

  • One rule to maintain: Instead of duplicating cursor rules across projects
  • Dynamic guidance: AI pulls relevant instructions based on current context
  • Shared knowledge: Same guidance available across all your projects
  • Version-controlled instructions: Track changes to your AI guidance over time

Features

CLI Interface

  • Create guidance entities with metadata
  • Retrieve single or multiple guidance documents
  • Update content and metadata
  • List and filter guidance by tags
  • Delete guidance entities

Storage

  • Backend-agnostic architecture
  • Filesystem backend included (stores as Markdown files with YAML frontmatter)
  • Hierarchical organization with aliases
  • Tag-based categorization and filtering

Output Formats

  • Human-readable formatted output
  • JSON output for programmatic use
  • Batch operations for multiple entities

Installation

Pre-built Binaries

See links at bottom

Build from Source

git clone https://github.com/ofthemachine/gydnc.git
cd gydnc
make build
sudo mv gydnc /usr/local/bin/

Quick Start

# Initialize a guidance repository
mkdir my-guidance && cd my-guidance
gydnc init .

# Set configuration
export GYDNC_CONFIG="$(pwd)/.gydnc/config.yml"

# Create guidance
echo "# Safety Guidelines\nValidate all inputs." | \
  gydnc create must/safety-first --title "Safety First" \
  --tags "quality:safety"

# List and retrieve guidance
gydnc list --json
gydnc get must/safety-first

Note: The filesystem backend works well with Git for version control, but Git is not required.

Implementation Details

This release includes:

Core Commands

  • Complete CLI interface (create, get, list, update, delete)
  • Filesystem backend with .g6e file format
  • YAML frontmatter with Markdown body content
  • Hierarchical alias system
  • Tag-based filtering

Infrastructure

  • Integration testing framework
  • GitHub Actions CI/CD
  • Multi-platform builds (Linux, macOS Intel/ARM)
  • Automated release process

Migration

  • Migrated from previous agentt project
  • Updated repository structure for standalone distribution
  • Preserved commit history

Contributors

  • Tim Frison - Primary developer
  • AI assistants (Claude, GPT, Gemini) provided development assistance

License

GNU Affero General Public License v3.0 with guidance content exception. See LICENSE for details.