mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-07 07:55:13 +02:00
c202202e6b
* feat(cli): clean up wiki and sl commands * test(scripts): update package artifact CLI smoke assertion
78 lines
1.8 KiB
Text
78 lines
1.8 KiB
Text
---
|
|
title: "ktx wiki"
|
|
description: "List or search knowledge pages."
|
|
---
|
|
|
|
Manage knowledge pages in your KTX project. Knowledge pages are Markdown documents that capture business definitions, rules, and gotchas. Agents search them for context when answering questions about your data.
|
|
|
|
## Command signature
|
|
|
|
```bash
|
|
ktx wiki <subcommand> [options]
|
|
```
|
|
|
|
## Subcommands
|
|
|
|
| Subcommand | Description |
|
|
|-----------|-------------|
|
|
| `list` | List local wiki pages |
|
|
| `search <query>` | Search local wiki pages |
|
|
|
|
## Options
|
|
|
|
### `wiki list`
|
|
|
|
| Flag | Description | Default |
|
|
|------|-------------|---------|
|
|
| `--json` | Print JSON output | `false` |
|
|
| `--user-id <id>` | Local user id | `local` |
|
|
|
|
### `wiki search`
|
|
|
|
| Flag | Description | Default |
|
|
|------|-------------|---------|
|
|
| `--json` | Print JSON output | `false` |
|
|
| `--user-id <id>` | Local user id | `local` |
|
|
| `--limit <number>` | Maximum search results | — |
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# List all wiki pages
|
|
ktx wiki list
|
|
|
|
# List all wiki pages as JSON
|
|
ktx wiki list --json
|
|
|
|
# Search wiki pages
|
|
ktx wiki search "monthly recurring revenue"
|
|
|
|
# Search wiki pages as JSON
|
|
ktx wiki search "monthly recurring revenue" --json --limit 10
|
|
```
|
|
|
|
## Output
|
|
|
|
Wiki commands print local knowledge pages and search results.
|
|
|
|
```json
|
|
{
|
|
"kind": "list",
|
|
"data": {
|
|
"items": [
|
|
{
|
|
"key": "revenue-definitions",
|
|
"summary": "Canonical revenue metric definitions",
|
|
"score": 0.92
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Common errors
|
|
|
|
| Error | Cause | Recovery |
|
|
|-------|-------|----------|
|
|
| Search returns no results | The query terms do not match summaries, tags, or content | Retry with business synonyms or run ingest to capture more context |
|
|
| A page is missing | The page has not been created by ingest or memory capture yet | Run ingest, then search again with `ktx wiki search` |
|