@veedubin/neuralgentics 0.9.4 → 0.9.5
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 +87 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# @veedubin/neuralgentics
|
|
2
|
+
|
|
3
|
+
Neuralgentics OpenCode Plugin — Multi-agent orchestration with trust-weighted memory, a permissions-based MCP broker, and context that survives sessions.
|
|
4
|
+
|
|
5
|
+
## What This Package Does
|
|
6
|
+
|
|
7
|
+
This npm package provides the Neuralgentics plugin for [OpenCode](https://github.com/modelcontextprotocol/opencode). It includes:
|
|
8
|
+
|
|
9
|
+
- **8 agent personas**: architect, coder, explorer, git, orchestrator, reviewer, tester, writer
|
|
10
|
+
- **5 skills**: boomerang-orchestrator, kanban-board-manager, skill-self-audit, todo-list-updater, update-gh-docs
|
|
11
|
+
- **MCP tools**: memory save/query, compaction backup/restore, stateless agent dispatch, self-evolution gate
|
|
12
|
+
- **Lifecycle hooks**: `session.created`, `session.idle`, `session.compacting`
|
|
13
|
+
- **Config merger**: Injects Neuralgentics version and memory URL into OpenCode config
|
|
14
|
+
|
|
15
|
+
## Install
|
|
16
|
+
|
|
17
|
+
Run this command in your project directory:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npx @veedubin/neuralgentics --init
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
### What `--init` Does
|
|
24
|
+
|
|
25
|
+
1. Downloads the latest `@veedubin/neuralgentics` release tarball.
|
|
26
|
+
2. Backs up your existing `.opencode/` directory (if any).
|
|
27
|
+
3. Deep-merges the plugin's `opencode.json` with your existing config (preserves your customizations).
|
|
28
|
+
4. Offers to set up the container stack (PostgreSQL + sidecar + backend).
|
|
29
|
+
- Skips if `neuralgentics-postgres` is already running.
|
|
30
|
+
- Never overwrites an existing `.env` file.
|
|
31
|
+
- If `.env` is missing, copies `compose.example.env` and stops (lets you edit credentials before starting).
|
|
32
|
+
5. Prints DB connection info after successful setup.
|
|
33
|
+
|
|
34
|
+
## Manual Install
|
|
35
|
+
|
|
36
|
+
If you prefer not to use `--init`, add the plugin to your `.opencode/opencode.json`:
|
|
37
|
+
|
|
38
|
+
```json
|
|
39
|
+
{
|
|
40
|
+
"plugins": [
|
|
41
|
+
"@veedubin/neuralgentics"
|
|
42
|
+
]
|
|
43
|
+
}
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Then run:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
npm install @veedubin/neuralgentics
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Requirements
|
|
53
|
+
|
|
54
|
+
- Node.js 20+
|
|
55
|
+
- OpenCode ^1.15.0
|
|
56
|
+
- Docker or Podman (for the optional container stack)
|
|
57
|
+
|
|
58
|
+
## Container Stack
|
|
59
|
+
|
|
60
|
+
The memory backend runs as 3 containers:
|
|
61
|
+
|
|
62
|
+
- `neuralgentics-postgres`: PostgreSQL 18 + pgvector + TimescaleDB (port 6000)
|
|
63
|
+
- `neuralgentics-sidecar`: Python gRPC embedding service (BGE-Large, port 50051)
|
|
64
|
+
- `neuralgentics-backend`: Go JSON-RPC memory server (trust engine, knowledge graph, thought chains)
|
|
65
|
+
|
|
66
|
+
Start them with:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
docker compose -f ~/.neuralgentics/docker-compose.yml up -d
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
## What You Get
|
|
73
|
+
|
|
74
|
+
- **Memory System**: Trust-weighted memory with PostgreSQL + pgvector, tiered loading (L0/L1/L2), and context continuity across sessions.
|
|
75
|
+
- **MCP Broker**: Permissions-based routing for 20+ MCP servers (GitHub, GitLab, filesystem, PostgreSQL, SQLite, Puppeteer, Playwright, etc.).
|
|
76
|
+
- **Orchestration**: 9-step Boomerang Protocol (Memory Query → Thought Chain → Planning → Delegation → Git Check → Quality Gates → IMPROVE → Doc Update → Memory Save).
|
|
77
|
+
- **Self-Evolution**: Auto-creates skills from repeated session patterns.
|
|
78
|
+
- **Kanban Board**: Tracks tasks in `TASKS.md` (triage, todo, ready, running, blocked, done, archived).
|
|
79
|
+
|
|
80
|
+
## License
|
|
81
|
+
|
|
82
|
+
MIT
|
|
83
|
+
|
|
84
|
+
## Links
|
|
85
|
+
|
|
86
|
+
- [GitHub Repository](https://github.com/Veedubin/neuralgentics)
|
|
87
|
+
- [Documentation](https://veedubin.github.io/neuralgentics/)
|
package/package.json
CHANGED