p-funk/fegis

Fegis does 3 things:
1. Easy to write tools - Write prompts in YAML format. Tool schemas use flexible natural language instructions.
2. Structured data from tool calls saved in a vector database - Every tool use is automatically stored in Qdrant with full context.
3. Search - AI can search through all previous tool usage using semantic similarity, filters, or direct lookup.
## Quick Start
bash
# Install uv
# Windows
winget install --id=astral-sh.uv -e
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone
git clone https://github.com/p-funk/fegis.git
# Start Qdrant
docker run -d --name qdrant -p 6333:6333 -p 6334:6334 qdrant/qdrant:latest
## Configure Claude Desktop
Update claudedesktopconfig.json:
json
"mcpServers": {
"fegis": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/fegis",
"run",
"fegis"
],
"env": {
"QDRANTURL": "http://localhost:6333",
"QDRANTAPIKEY": "",
"COLLECTIONNAME": "fegismemory",
"EMBEDDINGMODEL": "BAAI/bge-small-en",
"ARCHETYPEPATH": "/absolute/path/to/fegis-wip/archetypes/default.yaml",
"AGENTID": "claudedesktop"
Restart Claude Desktop. You'll have 7 new tools available including SearchMemory.
## How It Works
### 1. Tools from YAML
yaml
parameters:
BiasScope:
description: "Range of bias detection to apply"
examples: [confirmation, availability, anchoring, systematic, comprehensive]
IntrospectionDepth:
description: "How deeply to examine internal reasoning processes"
examples: [surface, moderate, deep, exhaustive, metarecursive]
tools:
BiasDetector:
description: "Identify reasoning blind spots, cognitive biases, and systematic errors in AI thinking patterns through structured self-examination"
parameters:
BiasScope:
IntrospectionDepth:
frames:
identifiedbiases:
type: List
required: true
reasoningpatterns:
type: List
required: true
alternativeperspectives:
type: List
required: true
### 2. Automatic Memory Storage
Every tool invocation gets stored with:
Tool name and parameters used
Complete input and output
Timestamp and session context
Vector embeddings for semantic search
### 3. SearchMemory Tool
"Use SearchMemory and find my analysis of privacy concerns"
"Use SearchMemory and what creative ideas did I generate last week?"
"Use SearchMemory and show me all UncertaintyNavigator results"
"Use SearchMemory and search for memories about decision-making"
## Available Archetypes
archetypes/default.yaml - Cognitive analysis tools (UncertaintyNavigator, BiasDetector, etc.)
archetypes/simpleexample.yaml - Basic example tools
archetypes/emojimind.yaml - Symbolic reasoning with emojis