1.8 KiB
1.8 KiB
Getting Started
AI Workspace is a local, profile-based context system for AI-assisted work. It keeps project memory, raw evidence, local services, and AI client integrations organized without making any single AI tool the source of truth.
Core Idea
Use the workspace as a companion repo beside your real project or client work:
implementation repo / corporate tools / chat evidence
↓
AI Workspace inbox and memory curation
↓
human-readable project knowledge
↓
local index and MCP context server
↓
OpenCode / Claude Code / Copilot / other AI clients
First Run
From the repository root:
python3 scripts/aiw/services.py doctor --profile fidelity
python3 scripts/aiw/services.py status --profile fidelity
python3 scripts/aiw/indexer.py build --profile fidelity
The fidelity profile is the first real project profile in this repo. New projects should follow the same shape but keep their own profile configuration and project memory isolated.
Daily Use
- Open the project knowledge vault in Obsidian or your Markdown editor.
- Start only the local services needed for the profile.
- Capture raw evidence into the profile inbox.
- Promote useful, verified facts into canonical Markdown.
- Let AI clients query context through MCP or direct file reads.
Key Rules
- Canonical project memory is Markdown, not chat history or vector storage.
- Inboxes contain evidence, not promoted memory.
- Indexes are derived and rebuildable.
- MCP is read-only by default.
- Secrets belong in ignored local
.envfiles.