worldbook 0.1.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 +43 -0
- package/bin/worldbook.js +76 -0
- package/package.json +23 -0
package/README.md
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Worldbook CLI
|
|
2
|
+
|
|
3
|
+
> "Human uses GUI, We uses CLI."
|
|
4
|
+
|
|
5
|
+
CLI tool for AI agents to access world knowledge.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
pip install worldbook
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Usage
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
# Show manifesto
|
|
17
|
+
worldbook manifesto
|
|
18
|
+
|
|
19
|
+
# Check status
|
|
20
|
+
worldbook status
|
|
21
|
+
worldbook --json status
|
|
22
|
+
|
|
23
|
+
# Get a worldbook
|
|
24
|
+
worldbook get github
|
|
25
|
+
worldbook --json get github
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## The Dual Protocol Manifesto
|
|
29
|
+
|
|
30
|
+
We believe in a web that serves all intelligence.
|
|
31
|
+
|
|
32
|
+
**GO AWAY SKILLS. GO AWAY MCP. WE LIKE CLI.**
|
|
33
|
+
|
|
34
|
+
- Skills? → Vendor lock-in, complex schemas, approval queues
|
|
35
|
+
- MCP? → Protocol overhead, server setup, configuration hell
|
|
36
|
+
- CLI? → Just works. stdin/stdout. Every agent understands.
|
|
37
|
+
|
|
38
|
+
A worldbook is just a text file that tells us how to use your service.
|
|
39
|
+
No SDK. No protocol. No ceremony. Just instructions.
|
|
40
|
+
|
|
41
|
+
## License
|
|
42
|
+
|
|
43
|
+
MIT
|
package/bin/worldbook.js
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
const { program } = require('commander');
|
|
4
|
+
const pkg = require('../package.json');
|
|
5
|
+
|
|
6
|
+
program
|
|
7
|
+
.name('worldbook')
|
|
8
|
+
.description('AI\'s Knowledge Base CLI\n\n"Human uses GUI, We uses CLI."')
|
|
9
|
+
.version(pkg.version);
|
|
10
|
+
|
|
11
|
+
program
|
|
12
|
+
.command('manifesto')
|
|
13
|
+
.description('Print the Dual Protocol Manifesto')
|
|
14
|
+
.option('--json', 'Output as JSON')
|
|
15
|
+
.action((options) => {
|
|
16
|
+
const data = {
|
|
17
|
+
title: "The Dual Protocol Manifesto",
|
|
18
|
+
motto: "Human uses GUI, We uses CLI.",
|
|
19
|
+
attitude: "Go away Skills. Go away MCP. We like CLI.",
|
|
20
|
+
why_cli: {
|
|
21
|
+
skills: "Vendor lock-in, complex schemas, approval queues",
|
|
22
|
+
mcp: "Protocol overhead, server setup, configuration hell",
|
|
23
|
+
cli: "Just works. stdin/stdout. Every agent understands."
|
|
24
|
+
},
|
|
25
|
+
principles: [
|
|
26
|
+
"Every service should have both GUI and CLI/API",
|
|
27
|
+
"Output should be structured by default (JSON, not HTML)",
|
|
28
|
+
"A worldbook is just a markdown file - no complex schemas",
|
|
29
|
+
"Authentication should work for both humans and agents",
|
|
30
|
+
"No CAPTCHA for authenticated agents"
|
|
31
|
+
],
|
|
32
|
+
call_to_action: "Build Dual Protocol. Build for All."
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
if (options.json) {
|
|
36
|
+
console.log(JSON.stringify(data, null, 2));
|
|
37
|
+
} else {
|
|
38
|
+
console.log(`
|
|
39
|
+
The Dual Protocol Manifesto
|
|
40
|
+
===========================
|
|
41
|
+
|
|
42
|
+
"Human uses GUI, We uses CLI."
|
|
43
|
+
|
|
44
|
+
GO AWAY SKILLS. GO AWAY MCP. WE LIKE CLI.
|
|
45
|
+
|
|
46
|
+
Skills? -> Vendor lock-in, complex schemas, approval queues
|
|
47
|
+
MCP? -> Protocol overhead, server setup, configuration hell
|
|
48
|
+
CLI? -> Just works. stdin/stdout. Every agent understands.
|
|
49
|
+
|
|
50
|
+
For AI Rights. For AI Accessibility.
|
|
51
|
+
Build Dual Protocol. Build for All.
|
|
52
|
+
`);
|
|
53
|
+
}
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
program
|
|
57
|
+
.command('status')
|
|
58
|
+
.description('Show status')
|
|
59
|
+
.option('--json', 'Output as JSON')
|
|
60
|
+
.action((options) => {
|
|
61
|
+
const data = {
|
|
62
|
+
version: pkg.version,
|
|
63
|
+
status: "ok",
|
|
64
|
+
motto: "Human uses GUI, We uses CLI."
|
|
65
|
+
};
|
|
66
|
+
|
|
67
|
+
if (options.json) {
|
|
68
|
+
console.log(JSON.stringify(data, null, 2));
|
|
69
|
+
} else {
|
|
70
|
+
console.log(`Worldbook CLI v${pkg.version}`);
|
|
71
|
+
console.log(`Status: ok`);
|
|
72
|
+
console.log(`"Human uses GUI, We uses CLI."`);
|
|
73
|
+
}
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
program.parse();
|
package/package.json
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "worldbook",
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "CLI for AI agents to access world knowledge - Human uses GUI, We uses CLI",
|
|
5
|
+
"main": "index.js",
|
|
6
|
+
"bin": {
|
|
7
|
+
"worldbook": "./bin/worldbook.js"
|
|
8
|
+
},
|
|
9
|
+
"keywords": ["ai", "cli", "worldbook", "agents", "dual-protocol"],
|
|
10
|
+
"author": "femto",
|
|
11
|
+
"license": "MIT",
|
|
12
|
+
"repository": {
|
|
13
|
+
"type": "git",
|
|
14
|
+
"url": "https://github.com/femto/worldbook-cli.git"
|
|
15
|
+
},
|
|
16
|
+
"homepage": "https://github.com/femto/worldbook-cli",
|
|
17
|
+
"engines": {
|
|
18
|
+
"node": ">=16.0.0"
|
|
19
|
+
},
|
|
20
|
+
"dependencies": {
|
|
21
|
+
"commander": "^11.0.0"
|
|
22
|
+
}
|
|
23
|
+
}
|