@holt-os/holt 0.0.1 → 0.0.2
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 +16 -18
- package/config.example.yml +1 -1
- package/dist/cli.js +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -2,27 +2,25 @@
|
|
|
2
2
|
|
|
3
3
|
**Everything you know, kept and connected.**
|
|
4
4
|
|
|
5
|
-
Holt is an open-source, self-hosted personal agent OS. Clone it, pick your skills, choose your brain
|
|
5
|
+
Holt is an open-source, self-hosted personal agent OS. Clone it, pick your skills, choose your brain, and it runs on *your* machine with persistent memory you can actually see and walk.
|
|
6
6
|
|
|
7
|
-
> A *holt* is a small wood
|
|
7
|
+
> A *holt* is a small wood: a sheltered place where things are kept and grow. That's the idea. A private home for your knowledge that compounds over time.
|
|
8
8
|
|
|
9
|
-
> 🚧 **Status: early development (Phase 0).** The architecture and roadmap are locked and the CLI skeleton is here, but Holt is not yet functional end-to-end. Star
|
|
9
|
+
> 🚧 **Status: early development (Phase 0).** The architecture and roadmap are locked and the CLI skeleton is here, but Holt is not yet functional end-to-end. Star or watch to follow along. Contributions welcome.
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
## Why Holt
|
|
14
14
|
|
|
15
|
-
- 🧠 **Memory you can see.** Persistent RAG memory plus a *navigable knowledge graph* of everything you feed it
|
|
16
|
-
- 🔌 **Any LLM.** Claude, OpenAI, Gemini, or a local model
|
|
15
|
+
- 🧠 **Memory you can see.** Persistent RAG memory plus a *navigable knowledge graph* of everything you feed it. No black-box profile you have to trust.
|
|
16
|
+
- 🔌 **Any LLM.** Claude, OpenAI, Gemini, or a local model. Swap your brain with one line of config. No vendor lock-in.
|
|
17
17
|
- 💸 **Local executes, cloud reviews.** Run a local model for the work and let a premium cloud model review only the risky, irreversible steps. Cheap and private by design.
|
|
18
|
-
- 🧩 **MCP plugin pantry.** Skills, channels, providers, embeddings
|
|
19
|
-
- 📚 **Standard skills.** Compatible with the [agentskills.io](https://agentskills.io) skill format
|
|
18
|
+
- 🧩 **MCP plugin pantry.** Skills, channels, providers, embeddings: everything is a plugin speaking the [Model Context Protocol](https://modelcontextprotocol.io). Extend it in any language.
|
|
19
|
+
- 📚 **Standard skills.** Compatible with the [agentskills.io](https://agentskills.io) skill format. Pull from the community catalog or publish your own.
|
|
20
20
|
- 🖥️ **CLI-first.** Works in your terminal the moment you clone. Telegram and other channels are opt-in.
|
|
21
21
|
|
|
22
22
|
## Quickstart
|
|
23
23
|
|
|
24
|
-
> Not functional yet — this is the intended interface (Phase 0).
|
|
25
|
-
|
|
26
24
|
```bash
|
|
27
25
|
npm install -g @holt-os/holt # or: pnpm add -g @holt-os/holt
|
|
28
26
|
holt init # pick your brain + memory (local or cloud)
|
|
@@ -38,23 +36,23 @@ holt skill add deep-research
|
|
|
38
36
|
|
|
39
37
|
## Configuration
|
|
40
38
|
|
|
41
|
-
Copy `config.example.yml` to `config.yml` and edit. See the file for the full schema
|
|
39
|
+
Copy `config.example.yml` to `config.yml` and edit. See the file for the full schema: brain/provider, memory and embeddings, output format (HTML or Markdown), orchestration, and channels.
|
|
42
40
|
|
|
43
41
|
## Architecture
|
|
44
42
|
|
|
45
|
-
Small strongly-typed **TypeScript core** (agent loop, brain router, memory orchestration, risky-action review gate, plugin dispatcher). *Everything else* is an MCP plugin
|
|
43
|
+
Small strongly-typed **TypeScript core** (agent loop, brain router, memory orchestration, risky-action review gate, plugin dispatcher). *Everything else* is an MCP plugin: providers, embeddings, skills, channels. See [`ARCHITECTURE.md`](./ARCHITECTURE.md).
|
|
46
44
|
|
|
47
45
|
## Roadmap
|
|
48
46
|
|
|
49
47
|
Built in always-shippable phases toward a full-vision v1:
|
|
50
48
|
|
|
51
|
-
0. **Skeleton
|
|
52
|
-
1. **Memory
|
|
53
|
-
2. **Any-LLM
|
|
54
|
-
3. **Skills
|
|
55
|
-
4. **Knowledge graph
|
|
56
|
-
5. **Orchestration
|
|
57
|
-
6. **Channels + polish
|
|
49
|
+
0. **Skeleton**: core loop + CLI *(in progress)*
|
|
50
|
+
1. **Memory**: sqlite-vec RAG + embeddings
|
|
51
|
+
2. **Any-LLM**: provider plugins + output toggle
|
|
52
|
+
3. **Skills**: agentskills.io catalog + installer
|
|
53
|
+
4. **Knowledge graph**: navigable memory view
|
|
54
|
+
5. **Orchestration**: local-executes / cloud-reviews
|
|
55
|
+
6. **Channels + polish**: Telegram, docs, one-command install
|
|
58
56
|
|
|
59
57
|
## Contributing
|
|
60
58
|
|
package/config.example.yml
CHANGED
package/dist/cli.js
CHANGED
|
@@ -28,7 +28,7 @@ Holt is in early development (Phase 0). Most commands are not wired up yet.
|
|
|
28
28
|
`;
|
|
29
29
|
function notReady(cmd) {
|
|
30
30
|
console.log(`
|
|
31
|
-
"${cmd}" is not implemented yet
|
|
31
|
+
"${cmd}" is not implemented yet. Holt is in Phase 0 (skeleton).`);
|
|
32
32
|
console.log(" Follow progress: https://github.com/holt-os/holt\n");
|
|
33
33
|
}
|
|
34
34
|
function main(argv) {
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@holt-os/holt",
|
|
3
|
-
"version": "0.0.
|
|
4
|
-
"description": "An open-source personal agent OS
|
|
3
|
+
"version": "0.0.2",
|
|
4
|
+
"description": "An open-source personal agent OS: any LLM, private memory you can see and walk.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"author": "Debashis Nayak",
|