@git-fabric/aiana
Aiana memory fabric app — semantic memory, session context, and cross-project recall as a composable MCP layer.
Part of the git-fabric ecosystem.
Tools
| Tool | Description |
|---|---|
aiana_memory_search | Semantic search over stored memories |
aiana_memory_add | Store a new memory (auto-scrubbed for secrets) |
aiana_memory_recall | Recall top-N relevant memories for a project |
aiana_memory_delete | Permanently delete a memory by ID |
aiana_memory_export | Export all memories as a JSONL-compatible array |
aiana_memory_import | Import memories from an exported array |
aiana_session_list | List sessions grouped by project |
aiana_preference_add | Store a user preference (type=preference memory) |
aiana_memory_feedback | Record helpfulness feedback on a recalled memory |
aiana_status | Collection stats: count, by-project breakdown, model |
aiana_health | Ping Qdrant Cloud, return latency |
Architecture
Follows the git-fabric layered pattern:
Detection / Query → layers/memories.ts (searchMemories, recallProjectContext)
Action → layers/memories.ts (addMemory, deleteMemory, import/export)
Sessions → layers/sessions.ts (read-only, derived from memory sessionIds)
Scrubbing → layers/scrub.ts (PII/secret redaction before embed+store)
Adapter → adapters/env.ts (Qdrant REST + OpenAI embeddings)
Surface → app.ts (FabricApp factory with 11 inline tools)
Zero footprint: no local state, no SQLite, no Redis. Qdrant Cloud is the only store.
Qdrant collection
| Property | Value |
|---|---|
| Collection | aiana_fabric__memories__v1 |
| Dimensions | 1536 |
| Distance | Cosine |
| Embedding model | text-embedding-3-small |
Usage
Via gateway (recommended)
# gateway.yaml
apps:
- name: "@git-fabric/aiana"
enabled: true
Standalone MCP server
QDRANT_URL=https://xxx.qdrant.io:6333 \
QDRANT_API_KEY=your-key \
OPENAI_API_KEY=sk-... \
npx @git-fabric/aiana
Programmatic
import { createApp } from "@git-fabric/aiana";
const app = createApp();
// app.tools, app.health(), etc.
Environment Variables
| Variable | Required | Description |
|---|---|---|
QDRANT_URL | Yes | Qdrant Cloud base URL (e.g. https://xxx.us-west-1-0.aws.cloud.qdrant.io:6333) |
QDRANT_API_KEY | Yes | Qdrant Cloud API key |
OPENAI_API_KEY | Yes | OpenAI API key for text-embedding-3-small embeddings |
Secret scrubbing
All content is scrubbed before embedding and storage. Redacted patterns:
- GitHub tokens (
ghp_,ghs_,github_pat_) - OpenAI keys (
sk-...) - Bearer tokens in headers
- JWT tokens (3-part base64)
- Password patterns
License
MIT