Files
nexa/docs/01-vision-and-scope.md
T
Claude 9b18e2710d Reorganize /docs with numbered TOC; deployment rewrite for actual homelab
- /docs/ now contains 12 numbered guides + index.md (navigator).
- Old duplicates removed: nexa-core/doc/, DEPLOYMENT.md, PLAN.md,
  config/{classification_logic,workflows_spec}.md.
- 09-deployment.md targets the running infra (LXC 104 docker host,
  Zoraxy at 192.168.1.4, existing Memos/n8n/LiteLLM/Nextcloud/Qdrant)
  rather than spinning a parallel stack; minimal-config approach.
- 11-open-questions.md tracks user-info-required blockers.
- 12-optimization-opportunities.md captures homelab tweaks.
- CLAUDE.md added so future agent runs know repo conventions and infra.
2026-05-04 21:18:28 +00:00

1.4 KiB

01 — Vision & Scope

Vision

Nexa is the central nervous system of a personal IT setup: an intelligent middleware sitting between input sources (Memos, e-mail, RSS, Karakeep, Bluesky), knowledge stores (Obsidian, Qdrant, Nextcloud) and organization tools (Nextcloud Calendar/Tasks).

Core goals

  • Cognitive offload — Nexa sorts, filters and proposes; it doesn't just store.
  • Context separation — clean AI-driven split between Work and Personal.
  • Single point of interaction — Memos is the primary surface ("voice & ear").
  • Knowledge synergy — link ephemeral memos to deep notes via semantic search.

Scope

In-scope

  • Triaging ~20 personal e-mails per day.
  • Routing tasks to the right Nextcloud list (Work vs. Personal).
  • Suggesting time-boxes in the work calendar.
  • Long-term memory in Qdrant (and optionally a graph DB).
  • Aggregating critical IT alerts (Proxmox, Backrest) into a Memos system feed.

Out-of-scope

  • Direct access to work IT (work mail, work servers).
  • Active document editing (metadata extraction only).
  • Replacing specialist UIs (Arcane / Dozzle / Portainer for containers).

Success metrics

  • Reduced mail interaction — less time in the mail app, more on the Nexa digest.
  • Calendar fill-rate — focus slots auto-blocked on the work calendar.
  • Search latency — old memos / Obsidian notes resurface instantly via #nexa:ask.