atxp-memory — Claude Code skill: what it does, how to install
atxp-memory backs up agent markdown memories to ATXP cloud storage and runs local vector search across notes without external network calls.
no license 736 installs ★ 11 updated 2026-04-27
npx skills add atxp-dev/cli --skill atxp-memory -a claude-codeWhat atxp-memory 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.
What it helps with
- 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 for the agent
- Push all memory files from
~/.openclaw/workspace-1/to the ATXP cloud - Index the markdown files inside
--path ./memoryand search for deployment notes - Check the backup and index status for our agent directory
How to install atxp-memory
1Skills CLI (Vercel)
npx skills add atxp-dev/cli --skill atxp-memory -a claude-code2Manually: put the files in place
~/.claude/skills/atxp-memory/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/atxp-memory/
1Skills CLI (Vercel)
npx skills add atxp-dev/cli --skill atxp-memory -a codex2Manually: put the files in place
.agents/skills/atxp-memory/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add atxp-dev/cli --skill atxp-memory -a cursor2Manually: put the files in place
.cursor/skills/atxp-memory/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install atxp-dev/cli skills/atxp-memory2Manually: put the files in place
.github/skills/atxp-memory/SKILL.md1Skills CLI (Vercel)
npx skills add atxp-dev/cli --skill atxp-memory -a gemini-cli2Platform CLI
gemini skills install https://github.com/atxp-dev/cli --path skills/atxp-memoryManually: put the files in place
.devin/skills/atxp-memory/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add atxp-dev/cli --skill atxp-memory -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about atxp-memory
How to install atxp-memory in Claude Code?
Run npx skills add atxp-dev/cli --skill atxp-memory -a claude-code. Alternatively, link the skill file via ~/.claude/skills/atxp-memory/SKILL.md.
What does atxp-memory do?
It syncs .md agent memory files with ATXP servers for disaster recovery and provides offline vector search across local notes via an embedded zvec database.
Does local memory search require an ATXP account?
No, indexing and searching run locally with @zvec/zvec without network access. Authentication via ATXP_CONNECTION is only required for cloud upload and download commands.