---
title: "ktx wiki"
description: "List or search wiki pages."
---

Manage wiki pages in your KTX project. Wiki 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 wiki page listings and search results. Open the
matching Markdown files directly when you need the full page contents.

```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, then create a page if the knowledge is missing |
| A page is missing | No Markdown file exists for that business context | Add a file under `wiki/` or run `ktx ingest <connectionId>` |
