How do I use @git-fabric/aiana?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@git-fabric/aiana Search my memories for the database schema notes from our last session" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@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