# Vanar Neutron Memory

> Store and retrieve agent memory using Vanar Neutron API. Use for saving information with semantic search, and persisting agent context between sessions.

- Skill: `kbarbel640-del/vanar-neutron-memory` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/vanar-neutron-memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/vanar-neutron-memory/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/vanar-neutron-memory

---


# Vanar Neutron Memory

Persistent memory storage with semantic search for AI agents. Save text as seeds, search semantically, and persist agent context between sessions.

## Prerequisites

API credentials via environment variables:
```bash
export NEUTRON_API_KEY=your_key
export NEUTRON_AGENT_ID=your_agent_id
export NEUTRON_EXTERNAL_USER_ID=your_agent_name_or_id  # agent_id name or defaults to 1
```

Or stored in `~/.config/neutron/credentials.json`:
```json
{
  "api_key": "your_key_here",
  "agent_id": "your_agent_id_here",
  "external_user_id": "your_agent_name_or_id"  // agent_id name or defaults to 1
}
```

## Testing

Verify your setup:
```bash
./scripts/neutron-memory.sh test  # Test API connection
```

## Scripts

Use the provided bash script in the `scripts/` directory:
- `neutron-memory.sh` - Main CLI tool

## Common Operations

### Save Text as a Seed
```bash
./scripts/neutron-memory.sh save "Content to remember" "Title of this memory"
```

### Semantic Search
```bash
./scripts/neutron-memory.sh search "what do I know about blockchain" 10 0.5
```

### Create Agent Context
```bash
./scripts/neutron-memory.sh context-create "my-agent" "episodic" '{"key":"value"}'
```

### List Agent Contexts
```bash
./scripts/neutron-memory.sh context-list "my-agent"
```

### Get Specific Context
```bash
./scripts/neutron-memory.sh context-get abc-123
```

## Interaction Seeds (Dual Storage)

When NeutronMemoryBot processes an interaction, it stores data in two places:

1. **Agent Context** - Truncated summary for structured metadata and session tracking
2. **Seed** - Full thread snapshot for semantic search

Each time the bot replies to a comment, the **full thread** (original post + all comments + the bot's reply) is saved as a seed. This means:

- Every seed is a complete conversation snapshot
- Later seeds contain more context than earlier ones
- Semantic search finds the most relevant conversation state
- Append-only: new snapshots are added, old ones remain

### Seed Format

```
Thread snapshot - {timestamp}

Post: {full post content}

Comments:
{author1}: {comment text}
{author2}: {comment text}
NeutronMemoryBot: {reply text}
```

## API Endpoints

- `POST /seeds` - Save text content (multipart/form-data)
- `POST /seeds/query` - Semantic search (JSON body)
- `POST /agent-contexts` - Create agent context
- `GET /agent-contexts` - List contexts (optional `agentId` filter)
- `GET /agent-contexts/{id}` - Get specific context

**Auth:** All requests require `Authorization: Bearer $NEUTRON_API_KEY` header and `appId`/`externalUserId` query params.

**Memory types:** `episodic`, `semantic`, `procedural`, `working`

**Text types for seeds:** `text`, `markdown`, `json`, `csv`, `claude_chat`, `gpt_chat`, `email`