wistra 0.1.8

AI-powered personal wiki builder
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

# wistra

AI-powered personal wiki builder. Scans a knowledge graph, fills stub concepts, resolves disambiguation, and keeps everything connected — entirely from the command line.

## Installation

```bash
cargo install wistra
```

## Quick Start

```bash
# Initial setup (configure API key, wiki path, interests)
wistra onboard

# Grow your wiki with AI-generated content
wistra run

# Scan and see wiki statistics
wistra scan

# Start a local web server to browse your wiki
wistra serve
```

## Commands

### Core

| Command | Description |
|---------|-------------|
| `wistra onboard` | Run the setup wizard |
| `wistra run` | Grow the wiki with AI-generated concepts |
| `wistra scan` | Scan wiki and print detailed report |
| `wistra status` | Print compact status summary |
| `wistra serve` | Start HTTP server to browse wiki |

### Document Management

| Command | Description |
|---------|-------------|
| `wistra rename <old> <new>` | Rename a document and update all links |
| `wistra merge <source> <target>` | Merge two documents |
| `wistra delete <title>` | Delete a document and clean up links |
| `wistra import <path>` | Import external markdown files |

### Analysis

| Command | Description |
|---------|-------------|
| `wistra backlinks <title>` | Show documents linking to a document |
| `wistra orphans` | Find documents with no incoming links |
| `wistra search <query>` | Full-text search across documents |
| `wistra graph <title>` | Show document connection graph |
| `wistra stats [type]` | Extended statistics (basic, trends, tags, links) |
| `wistra dedup` | Detect duplicate or similar documents |
| `wistra clean` | Detect and fix wiki technical debt |

### Tags

| Command | Description |
|---------|-------------|
| `wistra tags list` | List all tags with document counts |
| `wistra tags rename <old> <new>` | Rename a tag across all documents |
| `wistra tags merge <source> <target>` | Merge tags |
| `wistra tags orphans` | Find unused tags |

### Configuration

| Command | Description |
|---------|-------------|
| `wistra config` | Modify configuration |
| `wistra interests` | Modify interest domains |

## Wiki Format

Wistra uses standard Markdown with YAML frontmatter:

```markdown
---
title: Concept Name
aliases: ["Alternative Name"]
tags: ["category/subcategory"]
status: published
created: 2024-01-15
---

# Concept Name

Content goes here. Link to other concepts with [[Wikilinks]].

You can also use [[Target|display text]].
```

### Status Values

- `published` — Complete document
- `stub` — Placeholder waiting for content
- `disambiguation` — Disambiguation page
- `meta` — Index/meta document

## Configuration

Global configuration is stored at `~/.wistra/config.toml`:

```toml
wiki_path = "~/wiki"
language = "en"
interests = ["computer-science", "philosophy"]
```

Per-wiki configuration is stored at `<wiki>/.wistra/config.toml`.

## Requirements

- Rust 1.70+
- Claude Code CLI (for AI-powered features)

## License

MIT