Metadata-Version: 2.4
Name: skill-mnemo
Version: 1.0.1
Summary: CLI skill to query a personal knowledge base via OpenWebUI RAG
Project-URL: Repository, https://git.vauxoo.com/nhomar/skill-mnemo
License: MIT
Requires-Python: >=3.10
Requires-Dist: click>=8.0
Requires-Dist: requests>=2.28
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == 'dev'
Requires-Dist: python-semantic-release>=9.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# skill-mnemo

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

## Install

### From PyPI (once published)
```bash
pipx install skill-mnemo
```

### From repo (disponible ahora)
```bash
pipx install git+ssh://git@git.vauxoo.com/nhomar/skill-mnemo.git
```

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

## Setup

```bash
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

```bash
# 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).

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

## As an agent skill

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

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

<!-- trigger test release -->
