setup
/setup
Set up, repair or check the knowledge-base plugin backend (database, embedding model via Ollama, server binary), or move it from Postgres to SQLite. Use after installing the plugin, when the knowledge-base MCP server fails to connect, or when the user asks about the knowledge base installation.
- Author
- Bibob7 ↗
- Repository
- knowledge-base ↗
- Licence
- MIT
- Last repository change
- 10.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 10.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Set up, repair or check the knowledge-base plugin backend (database, embedding model via Ollama, server binary), or move it from Postgres to SQLite. Use after installing the plugin, when the knowledge-base MCP server fails to connect, or when the user asks about the knowledge base installation.
Arguments
/setup [--migrate-to-sqlite] [--database-url URL] [--postgres] [--embedding openai]
Original author description
Set up, repair or check the knowledge-base plugin backend (database, embedding model via Ollama, server binary), or move it from Postgres to SQLite. Use after installing the plugin, when the knowledge-base MCP server fails to connect, or when the user asks about the knowledge base installation.
How it works
SKILL.md has no level-two headings · 41 lines, 383 words
SKILL.md preview
---
name: setup
description: Set up, repair or check the knowledge-base plugin backend (database, embedding model via Ollama, server binary), or move it from Postgres to SQLite. Use after installing the plugin, when the knowledge-base MCP server fails to connect, or when the user asks about the knowledge base installation.
argument-hint: "[--migrate-to-sqlite] [--database-url URL] [--postgres] [--embedding openai]"
---
Set up the backend of the knowledge-base plugin. Run every command below exactly as written with the Bash tool:
the paths are filled in for this installation.
1. Check the current state:
```bash
CLAUDE_PLUGIN_DATA="${CLAUDE_PLUGIN_DATA}" "${CLAUDE_PLUGIN_ROOT}/scripts/setup.sh" --status
```
2. Explain the result to the user in a few lines. Before going on, ask about what you cannot decide alone:
- **Database**: by default the knowledge base is a SQLite file (`~/.local/share/knowledge-base/knowledge.db`);
nothing to install. Alternatives, only if the user wants them: `--database-url postgres://...` (an existing
Postgres with pgvector, e.g. a server shared by a team) or `--postgres` (a local Postgres in Docker).
An existing configuration keeps its database.
- **Postgres in Docker in use** (status shows the container): offer `--migrate-to-sqlite`. It copies everything
(IDs, history) into the SQLite file, switches the configuration and stops the container; the Docker volume
stays as a backup. Docker is then no longer needed. Use it only after the user agrees.
- **Missing prerequisites**: Ollama (local embeddings); without it `--embedding openai` (needs
`OPENAI_API_KEY` in the environment). Go is only needed if no release binary exists for this version or
platform. The user installs them; do not install system software yourself.
- **Pre-plugin installation found**: it runs alongside the plugin and would duplicate every hook and tool.
Recommend `--remove-legacy` (it removes the old hooks, rules file and MCP registration and takes over
the old configuration; the data stays). Use it only after the user agrees.
- If `$ARGUMENTS` contains options, use them.
3. Run the setup with the agreed options (it is idempotent; the first build can take a minute):
```bash
CLAUDE_PLUGIN_DATA="${CLAUDE_PLUGIN_DATA}" "${CLAUDE_PLUGIN_ROOT}/scripts/setup.sh" [options]
```
4. If it fails, read the message, fix what you can (e.g. start the setup again after the user started
Docker or Ollama) and otherwise tell the user what is missing. If it succeeds, tell the user to run
`/reload-plugins` (or restart Claude Code) so that the MCP server connects, and that the configuration
lives in `~/.config/knowledge-base/config.env`. After `--migrate-to-sqlite` the reload is urgent (running
sessions write into Postgres until then); pass on the script's hint about deleting the Docker volume later.
Never run `setup.sh --purge` unless the user explicitly asks to delete all knowledge: it deletes the SQLite file,
the Docker Postgres including its volume, and the configuration. Never delete the Docker volume yourself either.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · Bibob7/knowledge-base | 92 | MIT |
| HwangSlater/harness-fit | 100 | MIT |
| nesquikm/dev-process-toolkit | 100 | MIT |
| userKael/rastro | 100 | MIT |
| als-apg/osprey | 100 | BSD-3-Clause |
| dedujeong/gemba | 100 | Apache-2.0 |
| eigenwise/eigenwise-toolshed | 100 | MIT |
| awrshift/agent-memory-kit | 100 | MIT |
| lifecycle-innovations-limited/claude-ops | 100 | MIT |
Database snapshot: 13.11.2026 · package version 9e00d94c6a8e (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100mcp-server-sqlite
Use this skill when installing, configuring, and executing tools with the local SQLite file inspection and query execution SQLite MCP server. - 100knowledge-connect
Manage knowledge integration via MCP, Vector DBs, and A2A connectors. Use when: Connect to knowledge base, Ingest documentation, Query vector database, Setup RAG pipeline, Index project files. - 90agentdb-setup-diagnostics
Set up and diagnose the agentdb plugin and its MCP server — which profile and database are in use, whether the server is connected, what it holds, and why a tool is missing or refused. Use when AgentDB tools are missing, a call is refused, the user asks "is agentdb working", or… - 100kb-init
Use when setting up a new knowledge base, bootstrapping an Obsidian vault, or when user says 'init kb', 'new knowledge base', 'create kb', or 'setup vault'. Triggers on any request to initialize or scaffold a knowledge base project. - 100unifi-network-setup
Configure the UniFi Network MCP server for a supported MCP client — set controller host, credentials, and permissions. Also use when the unifi-network server failed to start or its tools are missing, especially right after a plugin update, because in Claude Code the plugin no… - 100unifi-access-setup
Configure the UniFi Access MCP server for a supported MCP client — set controller host, credentials, API key, and permissions. Also use when the unifi-access server failed to start or its tools are missing, especially right after a plugin update, because in Claude Code the…