-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Description
Project Information
Name: Kairos: The Context Keeper
Category: Open-source projects, Memory management, Build your own
Repository: https://github.com/turtir-ai/kairos-context-keeper
Description
Kairos is an open-source contextual memory system designed to solve the "contextual amnesia" problem in AI coding assistants. It provides persistent memory, project context awareness, and intelligent agent orchestration.
Key Features
- 🧠 Layered Memory Architecture: Combines Knowledge Graph for structural relationships with Vector Database for semantic search
- 🤖 Agent Guild System: Specialized autonomous agents for different tasks (coding, analysis, research, system monitoring)
- 🏛️ Integrity Guardian: Enforces project rules and coding standards defined in
.kiro/steering/
configuration - 🔌 Universal Integration (MCP): JSON-RPC server for seamless integration with AI IDEs like Cursor, Kiro, and others
- ⚙️ Daemon Architecture: Runs as background service with single
kairos start
command - 📈 Self-Improving: Learns from mistakes and optimizes performance over time
Technical Architecture
graph TD
subgraph "User & External World"
A[Developer] --> B{Terminal};
B -- "kairos [command]" --> C[Controller CLI];
A --> D{IDEs (Cursor, Kiro, Copilot)};
D -- MCP (JSON-RPC) --> E[Kairos MCP Server];
end
subgraph "Kairos Daemon"
F[Orchestrator & Flow Manager];
G[Integrity Guardian];
H[Agent Guild];
I[LLM Router];
J[Layered Memory (KG + VectorDB)];
K[Supervisor Agent];
end
C -- Control --> F;
E -- Request --> F;
F -- Assign Tasks --> H;
F -- Request Audit --> G;
G -- Use Constitution --> J;
H -- Request Info --> J;
F -- Request Model --> I;
K -- Monitor & Suggest --> F;
Quick Start
git clone https://github.com/turtir-ai/kairos-context-keeper.git
cd kairos-context-keeper
pip install -r requirements.txt
python src/cli.py start
Links
- GitHub: https://github.com/turtir-ai/kairos-context-keeper
- Documentation: https://docs.kairos-ai.org
- Discord: https://discord.gg/kairos-ai
- License: MIT
Why Add Kairos?
Kairos addresses a critical pain point in AI-assisted development - the loss of project context and memory across sessions. Unlike simple chatbots, it provides:
- Persistent Memory: Maintains project knowledge across sessions
- Context Awareness: Understands project architecture and coding standards
- Agent Orchestration: Coordinates multiple specialized AI agents
- Universal Integration: Works with any AI IDE through MCP protocol
- Self-Improvement: Continuously learns and optimizes
This makes it a valuable addition to the awesome-ai-agents list as it represents a new category of memory-enhanced AI systems.
This project is actively maintained and has received positive feedback from the AI development community for solving real-world context management challenges.