Skip to content

fugue-ai/rhema

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Rhema

License: Apache 2.0 Rust Crates.io

Transform implicit knowledge into explicit, persistent context that survives across AI conversations and development sessions.

Rhema (/ˈreɪmə/ "RAY-muh") is a Git-native toolkit that captures, organizes, and shares project knowledge through structured YAML files. It solves the fundamental problem of ephemeral context in AI-assisted development by making implicit knowledge explicit and persistent.

The name Rhema comes from the Greek word ῥῆμα, meaning "utterance" or "that which is spoken." Just as rhema represents the ephemeral nature of spoken knowledge, Rhema captures the ephemeral nature of development knowledge—those crucial insights, decisions, and context that exist in conversations, code reviews, and AI interactions but are often lost when the moment passes. By transforming these transient "utterances" of development wisdom into persistent, structured records, Rhema ensures that valuable knowledge endures beyond the immediate conversation or development session.

📖 Features

Core Functionality

  • Context Management - Intelligent context injection and management
  • Interactive Mode - Command-line interface with AI assistance
  • Batch Operations - Process multiple files and repositories
  • Git Integration - Seamless Git workflow integration
  • Configuration Management - Flexible configuration system
  • Performance Monitoring - Built-in performance tracking and optimization

Knowledge Management

  • Todo Management - Create, update, and track work items
  • Decision Tracking - Record and manage architectural decisions
  • Pattern Documentation - Document design patterns and best practices
  • Insight Capture - Capture and organize development insights

AI Integration

  • Agent Coordination - Manage and coordinate AI agents
  • Context Injection - Inject relevant context into AI conversations
  • Workflow Automation - Automate development workflows with AI assistance
  • MCP Integration - Model Context Protocol integration for AI tools

Advanced Features

  • CQL Support - Context Query Language for advanced knowledge discovery
  • Full-Text Search - Search across all knowledge artifacts
  • Semantic Search - AI-powered semantic search capabilities
  • Repository Analysis - Analyze repository structure and content

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/fugue-ai/rhema.git
cd rhema

# Install Rust (if not already installed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Build and install Rhema
cargo install --path .

Basic Usage

# Initialize Rhema in your project
rhema init

# Start interactive mode
rhema interactive

# Run a specific command
rhema query "find all TODO comments" # TODO: update with proper query that will always work in fugue-ai/rhema repo

For comprehensive CLI documentation and usage guides, see the CLI Documentation.

📚 Documentation

Viewing Documentation

Documentation Structure

  • Getting Started - Essential guides for new users
  • User Guide - Comprehensive feature documentation
  • Reference - Technical reference materials
  • Development Setup - Guides for contributors
  • Architecture - Design decisions and proposals
  • Examples - Practical use cases and examples

Core Values

Rhema is built on fundamental principles that guide every aspect of its design and functionality. These values shape how we approach knowledge management, team collaboration, and AI integration.

🤝 Collaborative Knowledge

Knowledge is a team asset, not an individual possession.

Rhema breaks down knowledge silos by making context discoverable and shareable across your entire organization. Every team member can contribute to and benefit from the collective understanding of your codebase.

🎯 AI-First, Universal Design

Context should be optimized for AI consumption, human reading, and traditional machines.

Rhema structures knowledge in ways that AI agents can effectively query, understand, and act upon. This enables consistent, context-aware AI behavior across all your development tools and conversations. In a tradeoff between human and traditional machine interactions, YAML is used as alternative to the traditional use of Markdown.

🎯 Explicit Over Implicit

Rhema's fundamental value proposition is making implicit knowledge explicit and persistent.

Before Rhema: Knowledge exists in individual minds, temporary chats, and scattered docs, leading to knowledge silos and inconsistent AI behavior.

After Rhema: Knowledge is structured, persistent, and discoverable across your entire team and AI interactions.

📈 Continuous Learning

Knowledge should accumulate and improve over time, not degrade.

Rhema preserves the full history of decisions, learnings, and patterns, allowing teams to build upon past insights rather than repeating the same discoveries. Context becomes a living, growing asset.

🔍 Discoverable Truth

The right information should find you, not require you to find it.

Rhema's powerful querying capabilities ensure that relevant context surfaces when and where it's needed. Whether through structured queries, full-text search, or AI-driven recommendations, knowledge flows to where it creates the most value.

🛠️ Development

For detailed development setup, workflow, and contribution guidelines, see our Contributing Guide.

📄 License

This project is licensed under the Apache License, Version 2.0 - see the LICENSE file for details.

🆘 Support

🗺️ Roadmap

See our Roadmap for upcoming features and improvements.

📊 Status

CI Crates.io License: Apache 2.0

About

ῥῆμα - Human-AI Memory and Context Framework founded in GitOps

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors