skill-mnemo

CLI skill to query a personal knowledge base via OpenWebUI RAG.

Install

From PyPI (once published)

pipx install skill-mnemo

From repo (disponible ahora)

pipx install git+ssh://git@git.vauxoo.com/nhomar/skill-mnemo.git

Actualizar

pipx upgrade skill-mnemo
# o desde repo:
pipx install git+ssh://git@git.vauxoo.com/nhomar/skill-mnemo.git --force

Setup

mnemo add-profile
# prompts for URL, API key, collection ID, and optional Cloudflare Access tokens

For nhomar's setup:

• URL: https://ai.me1980.com
• API key: in ~/Private/megalodonte-secrets.md
• Collection ID: 0de5a214-ba16-4470-99f8-29fabf1d7f02
• CF-Access-Client-Id / Secret: in ~/Private/megalodonte-secrets.md

Usage

# Query (uses default profile)
mnemo "how do I access code-server?"

# More results
mnemo "ollama models" --top 5

# JSON output (for agents/scripts)
mnemo "cloudflare ports" --json

# Named profile
mnemo "deploy process" --profile work

# Manage profiles
mnemo list-profiles
mnemo add-profile --name work

Credentials

Stored in ~/.config/skill-mnemo/credentials.json (mode 600).

{
  "default": {
    "url": "https://ai.me1980.com",
    "api_key": "sk-...",
    "collection_id": "...",
    "cf_client_id": "...",
    "cf_client_secret": "..."
  }
}

As an agent skill

# Any agent can call this and parse JSON output
mnemo "question" --json

Output:

[
  {"content": "...", "source": "CLAUDE.md", "score": 0.85},
  ...
]