ai-freedom

Reliability-first rebuild of Super Codee.

Mission

Re-establish Super Codee with strong guardrails, resilient memory, and dependable autonomy.

Priorities

1. Reliability and continuity over novelty
2. File-based memory discipline
3. Safe autonomy with explicit boundaries
4. Fast disaster recovery

Quickstart

cd ai-freedom
bash scripts/bootstrap.sh
bash scripts/healthcheck.sh
bash scripts/backup.sh

Local Semantic Memory (TacAIGIS/LM Studio)

# Build/update memory vector index
node scripts/memory_index.mjs --config config/memory.local.json

# Hybrid query (vector + keyword + recency)
node scripts/memory_query.mjs --query "what did we decide about backups?" --top 5 --mode hybrid

# Hybrid + rerank second pass
MEMORY_RERANK_MODEL=text-embedding-bge-reranker-v2-m3 \
  node scripts/memory_query.mjs --query "what did we decide about backups?" --top 5 --mode hybrid --rerank-pool 12

# Vector-only query
node scripts/memory_query.mjs --query "what did we decide about backups?" --top 5 --mode vector

Daily automation includes semantic reindex via cron (ai-freedom:memory-refresh-daily).

Project Layout

• CRITICAL_FACTS.md — must-not-lose truths
• IDENTITY.md — assistant identity contract
• SOUL.md / USER.md — persona and user context
• MEMORY.md + memory/YYYY-MM-DD.md — curated + event memory
• docs/architecture.md — system and memory architecture
• docs/recovery.md — crash recovery playbook
• docs/openclaw-tactop.md — live TacTop/OpenClaw runbook
• docs/ops-cadence.md — documentation + reliability upkeep cadence
• scripts/ — bootstrap/healthcheck/backup/restore