PHPackages                             conduit-ui/knowledge - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. conduit-ui/knowledge

ActiveLibrary[CLI & Console](/categories/cli)

conduit-ui/knowledge
====================

AI-powered knowledge base with semantic search and Qdrant vector database

v2.0.0(3mo ago)221MITPHPPHP ^8.2CI passing

Since Dec 29Pushed 1mo agoCompare

[ Source](https://github.com/conduit-ui/knowledge)[ Packagist](https://packagist.org/packages/conduit-ui/knowledge)[ Docs](https://github.com/conduit-ui/knowledge)[ RSS](/packages/conduit-ui-knowledge/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (13)Versions (23)Used By (0)

Knowledge CLI
=============

[](#knowledge-cli)

[![Sentinel Gate](https://github.com/conduit-ui/knowledge/actions/workflows/gate.yml/badge.svg)](https://github.com/conduit-ui/knowledge/actions/workflows/gate.yml)

AI-powered knowledge base with semantic search, Qdrant vector storage, and Ollama intelligence.

What It Does
------------

[](#what-it-does)

Captures technical decisions, learnings, and context from your work. Retrieves exactly what you need via semantic search — especially for AI pair programming with Claude Code.

```
# Add knowledge
./know add "Database Connection Fix" --content="Check .env before debugging migrations" --tags=debugging,database

# Semantic search
./know search "how to fix database issues"

# Show entry details
./know show
```

Architecture
------------

[](#architecture)

```
CLI (Laravel Zero)
    ↓
Tiered Search (narrow-to-wide retrieval across 4 tiers)
    ↓
Qdrant (Vector DB - all storage)
    ├── Per-project collections (auto-detected from git)
    └── Payload-based metadata (JSON)
    ↓
Redis (Cache layer - sub-200ms queries)
    ↓
Embedding Server (sentence-transformers)
    ↓
Ollama (optional - async auto-tagging via background queue)
    ↓
Remote Sync (optional - background sync to centralized server)

```

No SQLite. No schema migrations. Pure vector storage. Per-project isolation via auto-detected git namespaces.

Commands
--------

[](#commands)

All commands support `--project=` to target a specific project namespace and `--global` to search across all projects. Project is auto-detected from the current git repository.

### Core Knowledge

[](#core-knowledge)

CommandDescription`add`Add a knowledge entry (auto-detects git context, async Ollama tagging)`search`Semantic vector search with tiered narrow-to-wide retrieval`show `Display entry details`entries`List entries with filters`update `Update an existing entry`validate `Mark entry as validated (boosts confidence)`archive `Soft-delete an entry`export `Export a single entry`export:all`Bulk export all entries`correct`Correct/update knowledge with multi-tier propagation### Intelligence

[](#intelligence)

CommandDescription`context`Load semantic session context for AI tools`insights`AI-generated insights from your knowledge base`synthesize`Generate daily synthesis of knowledge themes`stage`Stage entries in daily log before permanent storage`promote`Promote staged entries to permanent knowledge`enhance:worker`Process the background Ollama enhancement queue### Infrastructure

[](#infrastructure)

CommandDescription`install`Initialize Qdrant collection`config`Manage configuration`stats`Analytics dashboard`search:status`Search infrastructure health check`agent:status`Dependency health checks (Qdrant, Redis, Ollama, Embeddings)`maintain`Run maintenance tasks`projects`List all project knowledge bases### Services (Docker)

[](#services-docker)

CommandDescription`service:up`Start Qdrant, Redis, embedding server`service:down`Stop services`service:status`Health check all services`service:logs`View service logs### Sync

[](#sync)

CommandDescription`sync`Bidirectional sync (--push / --pull)`sync:remote`Background sync to centralized remote server`sync:purge`Purge sync queue### Code Intelligence

[](#code-intelligence)

CommandDescription`index-code`Index codebase for semantic code search`search-code`Semantic search across indexed code`git:context`Display current git contextQuick Start
-----------

[](#quick-start)

### 1. Start Services

[](#1-start-services)

```
# Docker compose (Qdrant + embedding server)
make up

# Or manually
docker compose up -d
```

This starts:

- **Qdrant** on `http://localhost:6333` — Vector database
- **Embedding Server** on `http://localhost:8001` — sentence-transformers (all-MiniLM-L6-v2)

### 2. Initialize

[](#2-initialize)

```
./know install
```

### 3. Add Knowledge

[](#3-add-knowledge)

```
# With automatic git context detection
./know add "Fix Auth Timeout" --content="Increase token TTL in config/auth.php" --tags=auth,debugging

# Skip git detection
./know add "API Keys" --content="Store in vault, never in .env" --no-git
```

### 4. Search

[](#4-search)

```
# Semantic search
./know search "authentication timeout issues"

# With filters
./know search --category=debugging --tag=auth --limit=5
```

Configuration
-------------

[](#configuration)

`.env` file:

```
QDRANT_HOST=localhost
QDRANT_PORT=6333
EMBEDDING_SERVER_URL=http://localhost:8001
REDIS_HOST=localhost
REDIS_PORT=6379
OLLAMA_HOST=http://localhost:11434
```

### Remote Server (Production)

[](#remote-server-production)

Uses `docker-compose.remote.yml` to bind services to a specific network interface (e.g. Tailscale, VPN, LAN) for centralized knowledge sync across multiple machines.

Development
-----------

[](#development)

```
composer install          # Install dependencies
composer test             # Run tests (Pest, parallel)
composer test-coverage    # Run with coverage report
composer format           # Format code (Laravel Pint)
composer analyse          # Static analysis (PHPStan level 8)
```

Quality Standards
-----------------

[](#quality-standards)

- **Test Coverage**: 95% minimum (enforced by Sentinel Gate CI)
- **Static Analysis**: PHPStan Level 8 with strict rules
- **Code Style**: Laravel Pint (Laravel preset)
- **CI/CD**: Sentinel Gate auto-merges PRs after certification

Stack
-----

[](#stack)

- **Runtime**: PHP 8.2+, Laravel Zero
- **Vector DB**: Qdrant (Rust)
- **Cache**: Redis
- **Embeddings**: sentence-transformers (Python/FastAPI)
- **LLM**: Ollama (optional, for auto-tagging and query expansion)
- **HTTP Client**: Saloon
- **Testing**: Pest
- **CI**: GitHub Actions (Sentinel Gate)

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance87

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Total

3

Last Release

96d ago

Major Versions

v1.1.0 → v2.0.02026-02-11

### Community

Maintainers

![](https://www.gravatar.com/avatar/a6bb27de88a541a632427686306c8fc56366d72582f6a3316d20500efe7971f3?d=identicon)[conduit-ui](/maintainers/conduit-ui)

---

Top Contributors

[![jordanpartridge](https://avatars.githubusercontent.com/u/9040417?v=4)](https://github.com/jordanpartridge "jordanpartridge (77 commits)")

---

Tags

cliaiqdrantvector-databasesemantic-searchknowledge

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/conduit-ui-knowledge/health.svg)

```
[![Health](https://phpackages.com/badges/conduit-ui-knowledge/health.svg)](https://phpackages.com/packages/conduit-ui-knowledge)
```

###  Alternatives

[guanguans/ai-commit

Automagically generate conventional git commit message with AI. - 使用 AI 自动生成约定式 git 提交信息。

39231.2k10](/packages/guanguans-ai-commit)[bitfumes/laravel-packer

Awesome Command Line Tool for speeding up your package creation.

4391.3k](/packages/bitfumes-laravel-packer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)