Skip to content

docs: add README#160

Merged
jordanpartridge merged 2 commits into
masterfrom
docs/readme-refresh
Jul 3, 2026
Merged

docs: add README#160
jordanpartridge merged 2 commits into
masterfrom
docs/readme-refresh

Conversation

@jordanpartridge

Copy link
Copy Markdown
Contributor

Refreshes the README to match the current codebase after recent feature work (MCP tools, the-shit/vector connector, code vectorization, daemon/reindex commands).

What changed

  • Documented the local MCP server (routes/ai.phpKnowledgeServer), including all 8 tools (recall, remember, correct, context, stats, search-code, file-outline, symbol-lookup) and how to start it for an AI client — previously absent.
  • Fixed the configuration reference to match .env.example and config/search.php: QDRANT_EMBEDDING_SERVER (was EMBEDDING_SERVER_URL), split OLLAMA_HOST/OLLAMA_PORT, added QDRANT_ENABLED, EMBEDDING_PROVIDER, EMBEDDING_DIMENSION, hybrid search, and the ~/.knowledge/config.json override.
  • Corrected the services story: make up / docker-compose.yml starts Qdrant only (ports 6333/6334); the embedding server is external via QDRANT_EMBEDDING_SERVER.
  • Added missing commands: daemon:install, reindex:all, vectorize-code.
  • Updated the stack: embeddings/Qdrant now go through the the-shit/vector connector; corrected the install path (standalone CLI, git clone + composer install, optional Box PHAR).
  • Added Core Concepts, Requirements, Testing, and Contributing sections.

Every command signature, config key, and code reference was verified against source.

@lexi-chief-of-staff lexi-chief-of-staff Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ship it.

  • README now matches the live MCP server (routes/ai.php, KnowledgeServer) and the eight tools.
  • Config keys and service story updated to .env.example and config/search.php.
  • Commands section expanded to cover daemon:install, reindex:all, code vectorization, and the the-shit/vector stack.
  • No factual drift; every signature and key was cross-checked against source.

@lexi-chief-of-staff lexi-chief-of-staff Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ship it.

  • All 8 MCP tools listed match the actual registration in routes/ai.php and KnowledgeServer.php
  • Config keys now align with .env.example and config/search.php
  • Services section correctly reflects docker-compose.yml (Qdrant only) and external embedding server requirement
  • New commands (daemon:install, reindex:all, vectorize-code) are present in the source tree
  • Version numbers, stack, and testing instructions are accurate

No blocking issues found. Ready to merge.

@jordanpartridge jordanpartridge merged commit 3f34989 into master Jul 3, 2026
1 check passed
@jordanpartridge jordanpartridge deleted the docs/readme-refresh branch July 3, 2026 04:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant