chelydra
/
metal-kompanion
4
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Early developments of a new agentic assistant
30 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 db01fb0485 Add missing files 2025-10-16 03:46:06 +13:00
.acf Add testsystem 2025-10-15 01:22:29 +13: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 Extend command line and add db init. 2025-10-15 22:35:19 +13:00
doc Add missing files 2025-10-16 03:46:06 +13:00
docker docker: fix host ollama port 2025-10-13 08:17:38 +13:00
docs Convert to QtSql and extend 2025-10-16 03:45:27 +13:00
integrations Add missing files 2025-10-16 03:46:06 +13:00
resources/memory/kom.memory.v1 Added optional Postgres support: 2025-10-15 10:38:33 +13: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 Add missing files 2025-10-16 03:46:06 +13:00
tests Add missing files 2025-10-16 03:46:06 +13:00
tools Add changes made through MCP for backup 2025-10-14 13:22:44 +13: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 Add changes made through MCP for backup 2025-10-14 13:22:44 +13:00
CMakeLists.txt Convert to QtSql and extend 2025-10-16 03:45:27 +13:00
README.md First prototype 2025-10-15 15:16:56 +13:00
ledger.md Add changes made through MCP for backup 2025-10-14 13:22:44 +13:00
tasks-table.md Convert to QtSql and extend 2025-10-16 03:45:27 +13: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 – entry point (stub until qtmcp wired)
  • src/mcp/ToolSchemas.json – JSON Schemas for MCP tools
  • src/memory/ – interfaces for embedder and vector store
  • docs/ – design notes

Next

  • Add qtmcp dependency and implement server with tool registration.
  • 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/.