Repository navigation
gydnc v0.0.1
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) andshould/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/.gydncReplace 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-firstNote: 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
.g6efile 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
agenttproject - 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.