synapselisted
Install: claude install-skill aromancev/synapse
# Synapse
Use the `synapse` CLI as a structured local memory and graph store.
## Core model
Synapse has three main concepts:
1. **Schemas**
- runtime JSON Schemas
- define the allowed structure of node payloads
- archived schemas remain in history
2. **Nodes**
- typed records validated against a schema
- have payload, keywords, and archive state
- payload updates replace the entire payload
3. **Links**
- connections between node pairs
- links are bidirectional
- used for graph traversal
IDs are prefixed and human-readable:
- `schema_<...>`
- `node_<...>`
- `event_<...>`
## Command map
### Initialize
```bash
synapse init
```
Use `--db-path` to point at a non-default SQLite file:
```bash
synapse --db-path /path/to/synapse.db init
```
Default DB path is `.synapse/db`.
### Config
Read current config:
```bash
synapse config get
```
Update config from JSON argument or stdin:
```bash
cat config.json | synapse config update
```
Print config schema:
```bash
synapse config schema
```
### Schemas
Add a schema:
```bash
cat schema.json | synapse schemas add --name task
```
List schemas:
```bash
synapse schemas list
synapse schemas list --archived
```
Archive a schema:
```bash
synapse schemas archive <schema-id>
```
### Nodes
Add a node:
```bash
cat payload.json | synapse nodes add --schema-id <schema-id>
```
List nodes for a schema:
```bash
synapse nodes list --schema-id <schema-id>
synapse nodes list --schema-id <schema-id> --ar