Tools that Remember
for the Agentic Era
Built for Everyone
Whether you're an AI agent, a developer, or part of a team—Ixchel adapts to your workflow.
Context-aware AI assistants
Give your AI agents the memory they deserve. Structured JSON output, semantic search, and full context retrieval.
- --json output on all commands
- Semantic search for intelligent retrieval
- Token-aware context with ixchel context <id>
$ ixchel context iss-a1b2c3 --json
{
"id": "iss-a1b2c3",
"title": "Add OAuth2 authentication",
"status": "in_progress",
"blocks": ["iss-d4e5f6"],
"related": ["iss-g7h8i9"],
"embedding_similarity": 0.94
}How It Works
A simple architecture that keeps your data in git while enabling powerful queries.
Markdown Files
Human-readable, git-tracked
.ixchel/issues/*.mdHelixDB Index
Graph + Vector + BM25
Rebuilds from sourceSmart Queries
Semantic + keyword search
ixchel search "..."Delete the database? No problem. Run ixchel sync and it rebuilds from your Markdown files.
Core Principles
Git-First
Data stored in human-readable Markdown, YAML, and JSONL. Your repo is the source of truth.
Offline-First
Full functionality without network. Local embeddings via fastembed means no cloud dependencies.
Graph Intelligence
Traverse relationships between entities. Navigate your codebase structure naturally.
Hybrid Search
Combine vector semantic search with traditional BM25 keyword matching for best results.
Quick Start
# Install
cargo install --path apps/ix-cli
# Initialize in your project
ixchel init
# Create an issue
ixchel create issue "Add user authentication"
# Search semantically
ixchel search "how to handle auth"The Toolkit
Specialized tools composing via standard interfaces
ixchel
Git-first knowledge weaving system. Canonical Markdown artifacts + semantic search over your project memory.
ideas
Future tools and experiments are tracked as Ixchel ideas under .ixchel/ideas/ (git-first Markdown).
Standing on Giants' Shoulders
Inspired by brilliant projects in the AI tooling ecosystem
beads
Steve Yegge
swarm-tools
Joel Hooks
dots
Joel Reymont
.context
Andre Figueira