@romansmirnov/doku 1.0.3 → 1.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="doku.png" alt="Doku" width="
|
|
2
|
+
<img src="doku.png" alt="Doku" width="800" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
# Doku
|
|
@@ -15,11 +15,21 @@ A personal documentation system that stores docs as plain Markdown files and pro
|
|
|
15
15
|
- **Auto-save** — changes save automatically (1-second debounce)
|
|
16
16
|
- **Dark mode** — toggle between light and dark themes
|
|
17
17
|
- **Image support** — drag and drop images into documents
|
|
18
|
-
- **Frontmatter** — YAML metadata for ordering
|
|
18
|
+
- **Frontmatter** — YAML metadata for ordering
|
|
19
19
|
- **Breadcrumb navigation** — clickable path segments to navigate parent pages
|
|
20
|
-
- **Resizable sidebar** — drag the edge to adjust sidebar width
|
|
21
20
|
- **No database** — the filesystem is the single source of truth
|
|
22
21
|
|
|
22
|
+
## AI-Friendly
|
|
23
|
+
|
|
24
|
+
Doku is designed to work well with AI agents and coding assistants:
|
|
25
|
+
|
|
26
|
+
- **Plain Markdown** — all docs are standard `.md` files that AI agents can read and write directly
|
|
27
|
+
- **CLAUDE.md** — project conventions and rules for AI assistants working on the codebase
|
|
28
|
+
- **AGENTS.md** — detailed instructions for AI agents creating, editing, and organizing documentation files (frontmatter rules, folder conventions, ordering guidelines)
|
|
29
|
+
- **Simple file structure** — no database, no binary formats, no proprietary storage. Just files and folders that any tool can work with
|
|
30
|
+
- **CLI init** — agents can scaffold new doc projects with `npx @romansmirnov/doku init ./path`
|
|
31
|
+
- **REST API** — all operations available via HTTP endpoints for programmatic access
|
|
32
|
+
|
|
23
33
|
## Quick Start
|
|
24
34
|
|
|
25
35
|
```bash
|
|
@@ -52,7 +62,7 @@ open_docs.bat # Windows
|
|
|
52
62
|
|
|
53
63
|
## Configuration
|
|
54
64
|
|
|
55
|
-
|
|
65
|
+
Edit `config.json` inside your docs folder:
|
|
56
66
|
|
|
57
67
|
```json
|
|
58
68
|
{
|