chelydra
/
metal-kompanion
4
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Early developments of a new agentic assistant
43 Commits 3 Branches 0 Tags 461 KiB
C++ 80.1%
Python 12.6%
CMake 2.7%
Shell 2.3%
PLpgSQL 1.3%
Other 0.9%
Go to file
Χγφτ Kompanion 7b27493656 Add missing ingest files 2025-10-17 00:00:45 +02:00
.acf feat: Implement initial KompanionAI SDK structure and KLLM compatibility layer 2025-10-16 19:24:09 +02:00
.cursor/rules Add changes made through MCP for backup 2025-10-14 13:22:44 +13:00
bin Add changes made through MCP for backup 2025-10-14 13:22:44 +13:00
db Add bearer authentication based on namespace 2025-10-16 21:57:50 +02:00
doc Outline future plans 2025-10-16 04:55:58 +02:00
docker docker: fix host ollama port 2025-10-13 08:17:38 +13:00
docs Merge branch 'work/API' to switch to KompanionAi API 2025-10-16 21:59:51 +02:00
ingest Add missing ingest files 2025-10-17 00:00:45 +02:00
integrations Add missing files 2025-10-16 03:46:06 +13:00
resources feat: Implement initial KompanionAI SDK structure and KLLM compatibility layer 2025-10-16 19:24:09 +02:00
runtime runtime: Update runner script 2025-10-13 07:34:03 +13:00
sql/pg Add changes made through MCP for backup 2025-10-14 13:22:44 +13:00
src Merge branch 'work/API' to switch to KompanionAi API 2025-10-16 21:59:51 +02:00
tests Add bearer authentication based on namespace 2025-10-16 21:57:50 +02:00
tools Adapt defaults for ingest_dir 2025-10-16 22:36:12 +02:00
.clang-format feat: Implement initial KompanionAI SDK structure and KLLM compatibility layer 2025-10-16 19:24:09 +02:00
.gitignore feat: docker compose, shared infra docs, js-engine note 2025-10-13 00:05:01 +13:00
.push.sh feat: docker compose sandbox + initial skeleton & docs 2025-10-13 01:40:35 +13:00
AGENTS.md feat: Implement initial KompanionAI SDK structure and KLLM compatibility layer 2025-10-16 19:24:09 +02:00
CMakeLists.txt feat: Implement initial KompanionAI SDK structure and KLLM compatibility layer 2025-10-16 19:24:09 +02:00
README.md Implement server logic fully 2025-10-16 04:55:18 +02:00
build.log feat: Implement initial KompanionAI SDK structure and KLLM compatibility layer 2025-10-16 19:24:09 +02:00
ledger.md Add changes made through MCP for backup 2025-10-14 13:22:44 +13:00
tasks-table.md feat: Implement initial KompanionAI SDK structure and KLLM compatibility layer 2025-10-16 19:24:09 +02:00

README.md

metal-kompanion-mcp

MCP backend and memory provider for Kompanion. Uses qtmcp (Qt-based MCP) to expose tools under namespace kom.memory.v1.

Build

cmake -S . -B build
cmake --build build -j

Layout

  • src/main.cpp – QtMcp-backed entry point (stdio/SSE backends)
  • src/mcp/ToolSchemas.json – JSON Schemas for MCP tools
  • src/memory/ – interfaces for embedder and vector store
  • docs/ – design notes

Next

  • Add richer tool metadata + prompt support on top of the qtmcp server.
  • Implement adapters: embedder(s) + vector store(s).
  • Flesh out Postgres DAL paths (prepared statements + pgvector wiring).

Memory Tools

  • kom.memory.v1.save_context persists conversational or workspace state in a namespace.
  • kom.memory.v1.recall_context retrieves stored context by key, tags, or time window.
  • See docs/using-memory-tools.md for integration notes (Codey, Claude Code) and request samples.

Integrations

  • Kompanion-Konsole — demo plugin for KDE Konsole that lets agents hand terminals over to the Kompanion runtime. See integrations/konsole/README.md.
  • JavaScript helpers — Node.js utilities that call the MCP memory tools from scripts or web extensions. See integrations/js/.