2ndbrain 2026.1.30
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 +70 -0
- package/package.json +20 -0
package/README.md
ADDED
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# 2ndbrain
|
|
2
|
+
|
|
3
|
+
An always-on Node.js npx service that bridges Telegram messges to Claude with
|
|
4
|
+
* persistent conversation history (logs)
|
|
5
|
+
* receive text messages w/ attachments
|
|
6
|
+
* slash commands
|
|
7
|
+
* send text message responses w/ "Typing" indicator
|
|
8
|
+
* whitelist users that it will interact with (multi-layered)
|
|
9
|
+
* can run local commands, access local postgres (mcp) (whitelisted)
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
## Setup
|
|
13
|
+
|
|
14
|
+
* Start the `npx ...` runner on boot
|
|
15
|
+
* Ensure that local postgres & MCP are ready
|
|
16
|
+
* Ensure that claude-cli is ready
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
## Vision
|
|
20
|
+
|
|
21
|
+
* You setup `2ndbrain` on a computer on your LAN (e.g. rapsberry pi 5)
|
|
22
|
+
* You, and only you, can access with it by chatting over Telegram
|
|
23
|
+
* **2ndbrain** uses Claude + local MCP tools to do stuff and respond to you
|
|
24
|
+
* Web server interface
|
|
25
|
+
* Setup wizard
|
|
26
|
+
* Adjust settings & environment variables
|
|
27
|
+
* View activity logs
|
|
28
|
+
* GPIO interaction
|
|
29
|
+
* Auto-compact history
|
|
30
|
+
* Errors get pushed to the user
|
|
31
|
+
* Graceful shutdown/restart
|
|
32
|
+
* Rate-limiting of Claude and Telegram
|
|
33
|
+
* Store attachments in `~/data`
|
|
34
|
+
* Vector embeddings of db records
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
## Slashes
|
|
38
|
+
|
|
39
|
+
Enter slash commands in Telegram messages to perform tasks
|
|
40
|
+
|
|
41
|
+
`/status`
|
|
42
|
+
`/health`
|
|
43
|
+
`/restart`
|
|
44
|
+
`/reboot`
|
|
45
|
+
`/stop`
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
## Data Schema
|
|
49
|
+
|
|
50
|
+
* Projects(id, created, updated, name)
|
|
51
|
+
* Specifications(id, created, updated, project_id, note)
|
|
52
|
+
* Issues(id, created, updated, note, completed)
|
|
53
|
+
* _knowledge_graph
|
|
54
|
+
* Nodes(id, created, updated, name, note)
|
|
55
|
+
* Edges(id, created, updated, node1_id, node2_id, name)
|
|
56
|
+
* Journal(id, created, updated, note)
|
|
57
|
+
* Logs(id, timestamp, content, level)
|
|
58
|
+
* Embeddings(id, created, updated, entity_type, vector)
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
## Claude Stuff
|
|
62
|
+
|
|
63
|
+
Skills <TBD>
|
|
64
|
+
Hooks <TBD>
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
## Caveats
|
|
68
|
+
|
|
69
|
+
* Run Claude w/ top model, thinking, ?accept edits?
|
|
70
|
+
|
package/package.json
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "2ndbrain",
|
|
3
|
+
"version": "2026.1.30",
|
|
4
|
+
"description": "An always-on Node.js npx service that bridges Telegram messges to Claude with\r * persistent conversation history (logs)\r * receive text messages w/ attachments\r * slash commands\r * send text message responses w/ \"Typing\" indicator\r * whitelist users that it will interact with (multi-layered)\r * can run local commands, access local postgres (mcp) (whitelisted)",
|
|
5
|
+
"main": "index.js",
|
|
6
|
+
"scripts": {
|
|
7
|
+
"test": "echo \"Error: no test specified\" && exit 1"
|
|
8
|
+
},
|
|
9
|
+
"repository": {
|
|
10
|
+
"type": "git",
|
|
11
|
+
"url": "git+https://github.com/fingerskier/2ndbrain.git"
|
|
12
|
+
},
|
|
13
|
+
"keywords": [],
|
|
14
|
+
"author": "",
|
|
15
|
+
"license": "ISC",
|
|
16
|
+
"bugs": {
|
|
17
|
+
"url": "https://github.com/fingerskier/2ndbrain/issues"
|
|
18
|
+
},
|
|
19
|
+
"homepage": "https://github.com/fingerskier/2ndbrain#readme"
|
|
20
|
+
}
|