@seed-hypermedia/cli 0.1.0-alpha.1
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 +100 -0
- package/dist/index.js +38836 -0
- package/package.json +62 -0
package/README.md
ADDED
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
# Seed CLI
|
|
2
|
+
|
|
3
|
+
Command-line interface for [Seed Hypermedia](https://hyper.media).
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# Install globally
|
|
9
|
+
npm install -g @seed-hypermedia/cli
|
|
10
|
+
|
|
11
|
+
# Or run directly with npx
|
|
12
|
+
npx @seed-hypermedia/cli --help
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Usage
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
# Fetch a document
|
|
19
|
+
seed get hm://z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK
|
|
20
|
+
|
|
21
|
+
# Fetch as markdown
|
|
22
|
+
seed get hm://... --md
|
|
23
|
+
|
|
24
|
+
# Fetch with resolved embeds and queries
|
|
25
|
+
seed get hm://... --md --resolve
|
|
26
|
+
|
|
27
|
+
# Search
|
|
28
|
+
seed search "hello world"
|
|
29
|
+
|
|
30
|
+
# List accounts
|
|
31
|
+
seed accounts
|
|
32
|
+
|
|
33
|
+
# Query children
|
|
34
|
+
seed children z6Mkh...
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Configuration
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
# Set default server
|
|
41
|
+
export SEED_SERVER=https://dev.hyper.media
|
|
42
|
+
|
|
43
|
+
# Or use --server flag
|
|
44
|
+
seed --server https://hyper.media get hm://...
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Commands
|
|
48
|
+
|
|
49
|
+
### Read Operations
|
|
50
|
+
|
|
51
|
+
| Command | Description |
|
|
52
|
+
|---------|-------------|
|
|
53
|
+
| `get <id>` | Fetch document/entity |
|
|
54
|
+
| `account <uid>` | Get account info |
|
|
55
|
+
| `accounts` | List all accounts |
|
|
56
|
+
| `search <query>` | Full-text search |
|
|
57
|
+
| `query <space>` | List documents in space |
|
|
58
|
+
| `children <space>` | List child documents |
|
|
59
|
+
| `comments <id>` | List comments |
|
|
60
|
+
| `discussions <id>` | List threaded discussions |
|
|
61
|
+
| `changes <id>` | Document history |
|
|
62
|
+
| `citations <id>` | Backlinks |
|
|
63
|
+
| `capabilities <id>` | Access control |
|
|
64
|
+
| `activity` | Activity feed |
|
|
65
|
+
| `stats <id>` | Interaction statistics |
|
|
66
|
+
|
|
67
|
+
### Output Options
|
|
68
|
+
|
|
69
|
+
| Flag | Description |
|
|
70
|
+
|------|-------------|
|
|
71
|
+
| `--server <url>` | Server URL |
|
|
72
|
+
| `--json` | JSON output (default) |
|
|
73
|
+
| `--yaml` | YAML output |
|
|
74
|
+
| `--pretty` | Pretty formatted output |
|
|
75
|
+
| `-q, --quiet` | Minimal output (id + name) |
|
|
76
|
+
|
|
77
|
+
### Markdown Options (for `get`)
|
|
78
|
+
|
|
79
|
+
| Flag | Description |
|
|
80
|
+
|------|-------------|
|
|
81
|
+
| `--md` | Output as markdown |
|
|
82
|
+
| `--frontmatter` | Include YAML frontmatter |
|
|
83
|
+
| `-r, --resolve` | Resolve embeds, mentions, queries |
|
|
84
|
+
|
|
85
|
+
## Development
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
# Run in development
|
|
89
|
+
bun run dev
|
|
90
|
+
|
|
91
|
+
# Build for distribution
|
|
92
|
+
npm run build
|
|
93
|
+
|
|
94
|
+
# Type check
|
|
95
|
+
npm run typecheck
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## License
|
|
99
|
+
|
|
100
|
+
MIT
|