wokhei 0.2.2

Agent-first CLI for creating and publishing Decentralized List events on Nostr
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

# Wokhei

Agent-first CLI for creating and publishing Decentralized List events on Nostr using the [DCoSL protocol](https://github.com/wds4/brainstorm-knowledge-graph).

Every command returns structured JSON with `next_actions` — no plain text ever.

## Install

```bash
cargo install wokhei
```

## Quick Start

```bash
# Generate a keypair
wokhei init --generate

# Import a key from stdin (both forms are supported)
echo "nsec1..." | wokhei init --import=-
echo "nsec1..." | wokhei init --import -

# Create a list header
wokhei create-header --name=playlist --title="Jazz Favorites" --tags=jazz,music

# Add an item
wokhei add-item --header=<event-id> --resource="https://example.com/song"

# Query
wokhei list-headers
wokhei list-headers --name=playlist --offset=0 --limit=20
wokhei list-items <header-id>
wokhei list-items --header-coordinate="39998:<pubkey>:<d-tag>"
wokhei inspect <event-id>

# Utility
wokhei count
wokhei export --relay=wss://dcosl.brainstorm.world

# Delete (NIP-09 request)
wokhei delete <event-id>
```

## Relay Configuration

Default relay: `ws://localhost:7777`

Override with `--relay=<url>` flag or `WOKHEI_RELAY` env var:

```bash
export WOKHEI_RELAY=wss://dcosl.brainstorm.world
wokhei list-headers
```

## JSON Response Envelope

```json
{
  "ok": true,
  "command": "command-name",
  "timestamp": 1740000000,
  "schema_version": "wokhei.v1",
  "result": {},
  "next_actions": [
    { "command": "wokhei ...", "description": "What this does" }
  ]
}
```

## Event Kinds

| Kind | Type | Usage |
|------|------|-------|
| 9998 | Regular | One-off list header |
| 9999 | Regular | One-off list item |
| 39998 | Addressable | Persistent list header (keyed by d-tag) |
| 39999 | Addressable | Persistent list item (keyed by d-tag) |

## Agent Integration

See [SKILL.md](SKILL.md) for the full agent skill guide — error codes, tag schema, workflow patterns, and relay URLs.

## License

MIT