ima-claude 2.9.0 → 2.13.0

package/plugins/ima-claude/skills/mcp-gitea/SKILL.md

@@ -0,0 +1,358 @@
+---
+name: mcp-gitea
+description: >-
+  Gitea MCP for internal Git repository management — pull requests, issues, releases,
+  branches, tags, wikis, and CI/CD actions. Use when: creating/reviewing PRs, managing
+  issues, creating releases/tags, browsing repo contents, managing branches, wiki
+  operations, or any Gitea-hosted repository operation. Triggers on: Gitea, internal
+  repo, pull request, PR review, merge request, release, tag, branch, issue, milestone,
+  wiki, actions, CI/CD, timetracking. NOT for GitHub repos — use mcp-github for those.
+---
+
+# Gitea MCP - Internal Git Repository Management
+
+The team's internal Git platform. All tools prefixed `mcp__gitea__`.
+
+Gitea is the **primary** tool for daily development work (PRs, issues, releases).
+GitHub is FOSS publishing only — use `mcp-github` for GitHub operations.
+The `gh` CLI is GitHub-only; it does not work with Gitea.
+
+**Method-dispatch pattern:** Several tools (`pull_request_read`, `pull_request_write`, `pull_request_review_write`, `issue_read`, `issue_write`) use a required `method` parameter to select the operation. Always include `method` — omitting it causes a missing parameter error.
+
+## Tool Catalog
+
+### Identity & Discovery
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `get_me` | Current authenticated user | *(none)* |
+| `get_user_orgs` | User's organizations | *(none)* |
+| `search_users` | Search users by name/email | `query` |
+| `search_repos` | Search repositories across Gitea | `query`, `owner` |
+| `search_org_teams` | Find teams within an org | `org`, `query` |
+| `list_my_repos` | List authenticated user's repos | `page`, `perPage` |
+| `get_gitea_mcp_server_version` | Server version info | *(none)* |
+
+### Repository Operations
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `create_repo` | Create a new repository | `owner`, `name`, `description`, `private` |
+| `fork_repo` | Fork an existing repository | `owner`, `repo`, `organization` |
+| `get_file_contents` | Get file contents at a path | `owner`, `repo`, `filepath`, `ref` |
+| `get_dir_contents` | List directory contents | `owner`, `repo`, `filepath`, `ref` |
+| `create_or_update_file` | Create or update a file | `owner`, `repo`, `filepath`, `content`, `message`, `sha` (required for updates) |
+| `delete_file` | Delete a file | `owner`, `repo`, `filepath`, `message`, `sha` |
+
+### Branches
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `list_branches` | List all branches | `owner`, `repo`, `page`, `perPage` |
+| `create_branch` | Create a new branch | `owner`, `repo`, `new_branch_name`, `old_branch_name` |
+| `delete_branch` | Delete a branch | `owner`, `repo`, `branch` |
+
+### Pull Requests
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `list_pull_requests` | List PRs with filtering | `owner`, `repo`, `state` (open/closed/all), `sort`, `milestone`, `page`, `perPage` |
+| `pull_request_read` | Read PR data and reviews | `method` (get/get_diff/get_reviews/get_review/get_review_comments), `owner`, `repo`, `index`; `review_id` for get_review/get_review_comments |
+| `pull_request_write` | Create, update, merge PR; manage reviewers | `method` (create/update/merge/add_reviewers/remove_reviewers), `owner`, `repo`; `index` required except for create |
+| `pull_request_review_write` | Submit, delete, or dismiss a PR review | `method` (create/submit/delete/dismiss), `owner`, `repo`, `index`; `review_id` required for submit/delete/dismiss |
+
+**`pull_request_write` method details:**
+- `create`: `title` (req), `head` (req), `base` (req), `body`
+- `update`: `index` (req), `title`, `body`, `state`, `assignee`, `assignees`, `milestone`, `base`, `allow_maintainer_edit`
+- `merge`: `index` (req), `merge_style` (merge/rebase/rebase-merge/squash/fast-forward-only), `message`, `delete_branch`, `title`
+- `add_reviewers` / `remove_reviewers`: `index` (req), `reviewers` (string[]), `team_reviewers` (string[])
+
+**`pull_request_review_write` method details:**
+- `create`: `body`, `commit_id`, `comments` (inline array with `path`, `body`, `old_line_num`, `new_line_num`), `state`
+- `submit`: `review_id` (req), `body`, `state` (APPROVED/REQUEST_CHANGES/COMMENT/PENDING)
+- `delete`: `review_id` (req)
+- `dismiss`: `review_id` (req), `message`
+
+### Issues
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `list_issues` | List issues with filtering | `owner`, `repo`, `state` (default "all"), `page`, `perPage` |
+| `issue_read` | Get issue details, comments, or labels | `method` (get/get_comments/get_labels), `owner`, `repo`, `index` |
+| `issue_write` | Create, update, comment, or manage labels | `method` (create/update/add_comment/edit_comment/add_labels/remove_label/replace_labels/clear_labels), `owner`, `repo`; `index` required except for create |
+
+**`issue_write` method details:**
+- `create`: `title` (req), `body`, `assignees`, `labels` (number[]), `milestone`
+- `update`: `index` (req), `title`, `body`, `state`, `assignees`, `milestone`
+- `add_comment`: `index` (req), `body` (req)
+- `edit_comment`: `index` (req), `commentID` (req), `body` (req)
+- `add_labels` / `replace_labels`: `index` (req), `labels` (number[])
+- `remove_label`: `index` (req), `label_id` (number)
+- `clear_labels`: `index` (req)
+
+### Labels
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `label_read` | Get label details | `owner`, `repo`, `id` |
+| `label_write` | Create or update a label | `owner`, `repo`, `name`, `color` |
+
+### Milestones
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `milestone_read` | Get milestone details | `owner`, `repo`, `id` |
+| `milestone_write` | Create or update a milestone | `owner`, `repo`, `title`, `due_on`, `description` |
+
+### Releases & Tags
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `list_releases` | List all releases | `owner`, `repo`, `page`, `perPage` |
+| `get_release` | Get release by ID | `owner`, `repo`, `id` |
+| `get_latest_release` | Get the latest published release | `owner`, `repo` |
+| `create_release` | Create a new release | `owner`, `repo`, `tag_name`, `name`, `body`, `draft`, `prerelease` |
+| `delete_release` | Delete a release | `owner`, `repo`, `id` |
+| `list_tags` | List all tags | `owner`, `repo`, `page`, `perPage` |
+| `get_tag` | Get tag by name | `owner`, `repo`, `tag` |
+| `create_tag` | Create a new tag | `owner`, `repo`, `tag_name`, `message`, `target` |
+| `delete_tag` | Delete a tag | `owner`, `repo`, `tag` |
+
+### Commits
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `list_commits` | List commits on a branch | `owner`, `repo`, `sha`, `path`, `page`, `perPage` |
+
+### Wiki
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `wiki_read` | Read a wiki page | `owner`, `repo`, `pageName` |
+| `wiki_write` | Create or update a wiki page | `owner`, `repo`, `pageName`, `content`, `message` |
+
+### CI/CD Actions
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `actions_config_read` | Read workflow/actions config | `owner`, `repo` |
+| `actions_config_write` | Write workflow/actions config | `owner`, `repo`, `config` |
+| `actions_run_read` | Read action run details/logs | `owner`, `repo`, `run_id` |
+| `actions_run_write` | Trigger or manage action runs | `owner`, `repo`, `workflow_id`, `ref` |
+
+### Time Tracking
+
+| Tool | Purpose | Key Params |
+|------|---------|------------|
+| `timetracking_read` | Read time entries on an issue | `owner`, `repo`, `index` |
+| `timetracking_write` | Log time on an issue | `owner`, `repo`, `index`, `time` (seconds) |
+
+## Common Workflows
+
+### Create a Pull Request
+
+```
+1. Ensure your feature branch is pushed:
+   git push origin feature/my-branch
+
+2. pull_request_write(
+     method: "create",
+     owner: "FLCCC",
+     repo: "my-repo",
+     title: "feat: add new feature",
+     body: "## Summary\n- What changed\n- Why it changed\n\n## Test plan\n- [ ] Tested locally",
+     head: "feature/my-branch",
+     base: "main"
+   )
+```
+
+### Review a Pull Request
+
+```
+1. pull_request_read(method: "get", owner: "FLCCC", repo: "my-repo", index: 42)
+   → Review title, description, and diff summary
+
+2. pull_request_read(method: "get_reviews", owner: "FLCCC", repo: "my-repo", index: 42)
+   → Check existing reviews
+
+3. pull_request_review_write(
+     method: "create",
+     owner: "FLCCC",
+     repo: "my-repo",
+     index: 42,
+     state: "APPROVED",
+     body: "LGTM — clean implementation, tests look solid"
+   )
+   → Then submit it:
+   pull_request_review_write(
+     method: "submit",
+     owner: "FLCCC",
+     repo: "my-repo",
+     index: 42,
+     review_id: <id from create response>,
+     state: "APPROVED"
+   )
+```
+
+### Merge a Pull Request
+
+```
+pull_request_write(
+  method: "merge",
+  owner: "FLCCC",
+  repo: "my-repo",
+  index: 42,
+  merge_style: "squash",
+  delete_branch: true
+)
+```
+
+### Create a Release
+
+```
+1. get_latest_release(owner: "FLCCC", repo: "my-repo")
+   → Note current version for bump reference
+
+2. create_tag(
+     owner: "FLCCC",
+     repo: "my-repo",
+     tag_name: "v2.1.0",
+     message: "Release v2.1.0",
+     target: "main"
+   )
+
+3. create_release(
+     owner: "FLCCC",
+     repo: "my-repo",
+     tag_name: "v2.1.0",
+     name: "v2.1.0 — Feature Name",
+     body: "## Changes\n- ...\n\n## Breaking Changes\n- none",
+     draft: false,
+     prerelease: false
+   )
+```
+
+### Manage Issues
+
+```
+# Create an issue
+issue_write(
+  method: "create",
+  owner: "FLCCC",
+  repo: "my-repo",
+  title: "Bug: description of problem",
+  body: "## Steps to reproduce\n1. ...\n\n## Expected\n...\n\n## Actual\n..."
+)
+
+# Update an existing issue
+issue_write(
+  method: "update",
+  owner: "FLCCC",
+  repo: "my-repo",
+  index: 15,
+  body: "<updated body>"
+)
+
+# Add a comment
+issue_write(
+  method: "add_comment",
+  owner: "FLCCC",
+  repo: "my-repo",
+  index: 15,
+  body: "Confirmed — reproduced on v2.9.1."
+)
+
+# Filter open issues
+list_issues(
+  owner: "FLCCC",
+  repo: "my-repo",
+  state: "open",
+  perPage: 20
+)
+```
+
+### Browse Repo Contents
+
+```
+# List files in a directory
+get_dir_contents(owner: "FLCCC", repo: "my-repo", filepath: "src/", ref: "main")
+
+# Read a specific file
+get_file_contents(owner: "FLCCC", repo: "my-repo", filepath: "package.json", ref: "main")
+```
+
+## Decision Logic
+
+```
+Is this a Gitea-hosted repo?
+(check: git remote -v shows gitea.* or internal hostname)
+  → Yes: Use mcp__gitea__* tools  ← PRIMARY for daily work
+
+  → No: Is it GitHub-hosted? (github.com in remote URL)
+      → Yes: Use mcp__github__* tools (see mcp-github skill)
+             or gh CLI for GitHub-specific operations
+
+For local-only git operations (commit, diff, log, stash, rebase):
+  → Always use git CLI directly — no MCP needed for local ops
+
+Operation decision tree:
+  Creating a PR                → pull_request_write(method: "create")
+  Reading PR details/diff      → pull_request_read(method: "get" | "get_diff")
+  Reviewing a PR               → pull_request_review_write(method: "create" then "submit")
+  Merging a PR                 → pull_request_write(method: "merge")
+  Issue triage/tracking        → issue_write(method: "create" | "update") / list_issues
+  Adding a comment             → issue_write(method: "add_comment")
+  Cutting a release            → create_tag → create_release
+  Browsing file contents       → get_file_contents / get_dir_contents
+  Editing a file via MCP       → create_or_update_file (need sha for updates)
+  Branch management            → create_branch / delete_branch
+  CI/CD pipeline status        → actions_run_read
+  Team documentation           → wiki_write / wiki_read
+  Time logging                 → timetracking_write
+```
+
+## Token-Saving Strategies
+
+### 1. Paginate Large Lists
+
+```
+list_issues(owner: "FLCCC", repo: "my-repo", perPage: 15, page: 1)
+# Default can return 30+ items. Set perPage to what you actually need.
+```
+
+### 2. Filter by State
+
+```
+list_pull_requests(owner: "FLCCC", repo: "my-repo", state: "open")    # "open" | "closed" | "all"
+list_issues(owner: "FLCCC", repo: "my-repo", state: "open")           # Skip closed unless historical review
+```
+
+### 3. Target Specific Refs
+
+```
+get_file_contents(ref: "main")                              # Avoid default branch ambiguity
+list_commits(sha: "feature-branch", perPage: 10, page: 1)  # Last 10 commits only
+```
+
+### 4. Avoid Redundant Discovery
+
+Cache within a session (these don't change):
+- Owner/org names from `get_me` or `get_user_orgs`
+- Repo names once confirmed via `search_repos`
+- Label IDs once fetched via `label_read`
+- Milestone IDs once fetched via `milestone_read`
+
+### 5. Read Before Write (Files)
+
+`create_or_update_file` requires the current file `sha` for updates. Always call
+`get_file_contents` first to extract the `sha` — skipping this causes a 409 conflict error.
+
+## When NOT to Use Gitea MCP
+
+| Situation | Use Instead |
+|-----------|-------------|
+| GitHub-hosted repo (github.com) | `mcp__github__*` tools or `gh` CLI |
+| Local git operations (commit, diff, stash, rebase, cherry-pick) | `git` CLI directly |
+| Pushing/pulling code | `git push` / `git pull` (git CLI) |
+| GitHub Actions (github.com CI) | `gh` CLI |
+| Cloning a repo | `git clone` (git CLI) |

package/plugins/ima-claude/skills/mcp-github/SKILL.md

@@ -0,0 +1,200 @@
+---
+name: mcp-github
+description: >-
+  GitHub MCP for FOSS and public repository management — pull requests, issues, code
+  review, repository search, and GitHub API operations. Use when: working with GitHub-hosted
+  repos, creating PRs for open source, managing GitHub issues, searching public repos, or
+  any github.com operation. Triggers on: GitHub, github.com, open source, FOSS, public repo,
+  gh pr, gh issue, upstream PR. NOT for internal repos — use mcp-gitea for Gitea-hosted repos.
+  Falls back to gh CLI when MCP tools unavailable.
+---
+
+# GitHub MCP - FOSS & Public Repository Management
+
+Use GitHub MCP tools for GitHub-hosted repositories. Falls back to the `gh` CLI when MCP tools aren't available.
+
+## Setup
+
+Requires `GITHUB_PERSONAL_ACCESS_TOKEN` in your environment:
+
+```bash
+export GITHUB_PERSONAL_ACCESS_TOKEN=ghp_yourtoken
+```
+
+The GitHub MCP server is HTTP-based at `api.githubcopilot.com`. Tools are prefixed `mcp__github__*` and are **dynamically served** — exact tool names may vary. If a tool call fails with "tool not found", fall back to the `gh` CLI table below.
+
+## Tool Catalog
+
+GitHub MCP tools map to GitHub REST API operations. Expected tools by category:
+
+**Repository**
+
+| Tool (expected) | Purpose |
+|-----------------|---------|
+| `mcp__github__search_repositories` | Find public repos by query |
+| `mcp__github__get_repository` | Get repo metadata (stars, forks, topics) |
+| `mcp__github__list_repository_contents` | List files/dirs in a repo |
+| `mcp__github__get_file_contents` | Read a file from any branch/commit |
+| `mcp__github__create_repository` | Create a new GitHub repo |
+| `mcp__github__fork_repository` | Fork a repo to your account |
+
+**Pull Requests**
+
+| Tool (expected) | Purpose |
+|-----------------|---------|
+| `mcp__github__list_pull_requests` | List PRs with filters (state, label, author) |
+| `mcp__github__get_pull_request` | Get PR details including diff metadata |
+| `mcp__github__create_pull_request` | Open a new PR |
+| `mcp__github__update_pull_request` | Edit title, body, labels, assignees |
+| `mcp__github__merge_pull_request` | Merge a PR (merge, squash, or rebase) |
+| `mcp__github__list_pull_request_reviews` | Get review status |
+| `mcp__github__create_pull_request_review` | Submit a review (approve, request changes, comment) |
+| `mcp__github__list_pull_request_comments` | List inline code comments |
+
+**Issues**
+
+| Tool (expected) | Purpose |
+|-----------------|---------|
+| `mcp__github__list_issues` | List issues with filters |
+| `mcp__github__get_issue` | Get issue details and comments |
+| `mcp__github__create_issue` | Open a new issue |
+| `mcp__github__update_issue` | Edit title, body, state, assignees, labels |
+| `mcp__github__list_issue_comments` | Get all comments on an issue |
+| `mcp__github__add_issue_comment` | Post a comment on an issue |
+
+**Code & Files**
+
+| Tool (expected) | Purpose |
+|-----------------|---------|
+| `mcp__github__search_code` | Search code across GitHub repos |
+| `mcp__github__create_or_update_file` | Commit a file change via API |
+
+**Users & Orgs**
+
+| Tool (expected) | Purpose |
+|-----------------|---------|
+| `mcp__github__get_user` | Get GitHub user profile |
+| `mcp__github__search_users` | Find GitHub users |
+
+## `gh` CLI Fallback
+
+When MCP tools aren't available or sufficient, use the `gh` CLI:
+
+| Operation | `gh` Command |
+|-----------|-------------|
+| Create PR | `gh pr create --title "..." --body "..."` |
+| List PRs | `gh pr list` |
+| View PR | `gh pr view 123` |
+| Merge PR | `gh pr merge 123 --squash` |
+| Create issue | `gh issue create --title "..." --body "..."` |
+| List issues | `gh issue list` |
+| Close issue | `gh issue close 123` |
+| View repo | `gh repo view owner/name` |
+| Fork repo | `gh repo fork owner/name` |
+| Clone fork | `gh repo clone owner/name` |
+| Search repos | `gh search repos "query"` |
+| Search code | `gh search code "query" --repo owner/name` |
+| View file | `gh api repos/owner/name/contents/path` |
+
+## Decision Logic
+
+```
+Check git remote: git remote -v
+
+No remote configured?
+  → Local-only repo. Use git CLI directly.
+
+Does the remote point to github.com?
+  → Yes: Use mcp__github__* tools
+      → MCP tools not available or responding?
+        → Use gh CLI as fallback
+  → No: Does it point to gitea.* / internal hostname?
+      → Yes: Use mcp__gitea__* tools (see mcp-gitea skill)
+      → Unknown: Check with the user
+
+For local-only git operations (commit, diff, log, stash, branch):
+  → Always use git CLI directly — no MCP needed
+```
+
+## Common Workflows
+
+### Create a PR for a FOSS Project
+
+```
+1. Confirm the remote is github.com:
+   git remote -v
+
+2. Create the PR:
+   mcp__github__create_pull_request
+     owner: "FLCCC"
+     repo:  "ima-claude"
+     title: "feat: add mcp-github skill"
+     body:  "## Summary\n..."
+     head:  "feat/mcp-github-skill"
+     base:  "main"
+```
+
+### Manage Issues
+
+```
+# Open a bug report
+mcp__github__create_issue
+  owner: "FLCCC"
+  repo:  "ima-claude"
+  title: "Bug: skill not loading"
+  body:  "Steps to reproduce..."
+  labels: ["bug"]
+
+# Close with a comment
+mcp__github__add_issue_comment
+  owner: "FLCCC"
+  repo:  "ima-claude"
+  issue_number: 42
+  body: "Fixed in v2.11.0"
+
+mcp__github__update_issue
+  owner: "FLCCC"
+  repo:  "ima-claude"
+  issue_number: 42
+  state: "closed"
+```
+
+### Search Public Repos
+
+```
+mcp__github__search_repositories
+  query: "claude code skills mcp"
+  sort: "stars"
+
+# Or via gh CLI:
+gh search repos "claude mcp skills" --sort stars --limit 10
+```
+
+### Review a PR
+
+```
+mcp__github__get_pull_request
+  owner: "FLCCC"
+  repo:  "ima-claude"
+  pull_number: 15
+
+mcp__github__create_pull_request_review
+  owner: "FLCCC"
+  repo:  "ima-claude"
+  pull_number: 15
+  event: "APPROVE"
+  body: "LGTM"
+```
+
+## When NOT to Use
+
+- Internal Gitea repos — use `mcp-gitea` skill instead
+- Local git operations (commit, diff, stash) — use `git` CLI directly
+- Reading local files — use the Read tool, not the GitHub API
+- GitHub Actions configuration — edit files locally and push
+
+## Notes
+
+- GitHub MCP tools are **dynamically served** — exact names may differ. If a tool call fails with "tool not found", fall back to `gh` CLI.
+- The `gh` CLI is reliable and covers the majority of GitHub operations. MCP adds value for structured responses (search, bulk operations, code review workflows).
+- Always confirm the target remote (`git remote -v`) before deciding which tool to use.

package/plugins/ima-claude/skills/mcp-qdrant/SKILL.md

@@ -19,14 +19,18 @@ Our permanent reference library. Unlike Vestige (neural memory that fades if unu
 
 ## Embedding Stack
 
-| Component | Value |
-|---|---|
-| MCP server | `qdrant-mcp` (custom, at `~/dev/qdrant-mcp-server`) |
-| Embedding model | `nomic-embed-text` via Ollama |
-| Vector dimensions | 768 |
-| Distance metric | Cosine |
-| Vector type | Default (unnamed) |
-| Default collection | `ima-knowledge` |
+Two embedding providers are supported. Ollama is the default; fastembed is a CPU-only alternative for machines where Ollama has performance issues.
+
+| Component | Ollama (default) | fastembed |
+|---|---|---|
+| MCP server | `qdrant-mcp` (custom, at `~/dev/qdrant-mcp-server`) | same |
+| Embedding model | `nomic-embed-text` | `BAAI/bge-small-en-v1.5` |
+| Vector dimensions | 768 | 384 |
+| Distance metric | Cosine | Cosine |
+| Dependency | Ollama running locally | `pip install qdrant-mcp[fastembed]` |
+| Default collection | `ima-knowledge` | `ima-knowledge` |
+
+**Warning**: Collections can't be shared across providers (different vector dimensions). Switching providers requires a collection rebuild.
 
 ## Per-Project Collection
 
@@ -176,6 +180,8 @@ IF starting any new work:
 | Irrelevant results | Use more specific key terms |
 | Qdrant not responding | `docker ps \| grep qdrant` — restart if needed |
 | Ollama not responding | `ollama list` — ensure it's running with `nomic-embed-text` |
+| fastembed not installed | `pip install qdrant-mcp[fastembed]` |
+| Switched providers, bad results | Different vector dimensions — rebuild the collection |
 | Duplicate content | Search before storing to verify novelty |
 
 ## When NOT to Use
@@ -195,9 +201,12 @@ docker run -d --name qdrant \
   -v qdrant_storage:/qdrant/storage \
   qdrant/qdrant:latest
 
-# 2. Install Ollama and pull embedding model
+# 2a. Option A: Ollama (default)
 ollama pull nomic-embed-text
 
+# 2b. Option B: fastembed (CPU-only, no Ollama needed)
+# pip install qdrant-mcp[fastembed]
+
 # 3. Install custom MCP server
 cd ~/dev/qdrant-mcp-server && pip install -e .
 
@@ -209,17 +218,19 @@ cd ~/dev/qdrant-mcp-server && pip install -e .
 #   "env": {
 #     "QDRANT_URL": "http://localhost:6333",
 #     "COLLECTION_NAME": "ima-knowledge",
+#     "EMBEDDING_PROVIDER": "ollama",
 #     "OLLAMA_URL": "http://localhost:11434",
 #     "EMBEDDING_MODEL": "nomic-embed-text"
 #   }
 # }
+# For fastembed, set EMBEDDING_PROVIDER=fastembed (OLLAMA_URL not needed)
 
 # 5. Verify
 curl http://localhost:6333/health
 ```
 
 **Persistence**: `-v qdrant_storage:/qdrant/storage` preserves data across restarts.
-**Embeddings**: Ollama with `nomic-embed-text` (768d). All data stays on your machine.
+**Embeddings**: Ollama with `nomic-embed-text` (768d) or fastembed with `bge-small-en-v1.5` (384d). All data stays on your machine.
 
 ### Per-Project Setup