# atxp-memory

atxp-memory backs up agent markdown memories to ATXP cloud storage and runs local vector search across notes without external network calls.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 736 installs · ★ 11 repo stars
- Author: atxp-dev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/atxp-dev/cli/tree/HEAD/skills/atxp-memory/SKILL.md
- Updated: 2026-04-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/atxp-memory

## What it does

This skill manages agent state stored in `.md` files. Running `push` collects markdown files from a target directory and uploads a fresh snapshot to ATXP servers, replacing the prior server snapshot. When setting up a new environment, `pull` downloads those files without deleting local documents that are absent on the server.

To retrieve relevant context, the skill segments markdown documents at h1, h2, or h3 boundaries and generates a local HNSW index inside `.atxp-memory-index/`. It maps text chunks into 256-dimensional vectors using unigram and bigram feature hashing. This approach skips neural embeddings entirely, keeping search fast and free of external API fees.

Running `index` or `search` fails unless the optional `@zvec/zvec` package is installed. An `ATXP_CONNECTION` token is mandatory for pushing or pulling snapshots, while local index operations run strictly offline.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add atxp-dev/cli --skill atxp-memory -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/atxp-memory/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/atxp-memory/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add atxp-dev/cli --skill atxp-memory -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/atxp-memory/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add atxp-dev/cli --skill atxp-memory -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/atxp-memory/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install atxp-dev/cli skills/atxp-memory
```

2. **Manually: put the files in place**
- File: `.github/skills/atxp-memory/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add atxp-dev/cli --skill atxp-memory -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/atxp-dev/cli --path skills/atxp-memory
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/atxp-memory/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add atxp-dev/cli --skill atxp-memory -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/atxp-dev/cli/tree/HEAD/skills/atxp-memory/SKILL.md

## When to use it
- upload markdown memory snapshots to ATXP cloud storage
- restore agent memory files in a fresh workspace
- run offline similarity search across past agent notes
- check cloud backup status and local index statistics

## Example prompts
- Push all memory files from `~/.openclaw/workspace-1/` to the ATXP cloud
- Index the markdown files inside `--path ./memory` and search for deployment notes
- Check the backup and index status for our agent directory

## Similar
- [Lithtrix — Identity, Memory & Trust for AI Agents](https://affpapa.org/en/nevibecode/mcp/lithtrix-identity-memory-trust-for-ai-agents.md) — MCP server · ★ 1 repo stars
- [memory-search](https://affpapa.org/en/nevibecode/skills/ruvnet-memory-search.md) — skill · 751 installs
- [video-memory](https://affpapa.org/en/nevibecode/skills/video-memory.md) — skill · 748 installs
- [memory-bridge](https://affpapa.org/en/nevibecode/skills/ruvnet-memory-bridge.md) — skill · 745 installs
- [context-memory](https://affpapa.org/en/nevibecode/plugins/context-memory.md) — plugin · ★ 1013 repo stars
- [manage-memory](https://affpapa.org/en/nevibecode/commands/manage-memory.md) — command · ★ 276 repo stars

From the same set: [atxp-dev/cli](https://affpapa.org/en/nevibecode/by/atxp-dev/cli.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
