Acontext

memodb-io/Acontext

Agent Skills as a Memory Layer

3.6k
Stars
323
Forks
35
Open issues
27
Watchers
JavaScript Apache-2.0Last pushed Jun 30, 2026

Overview

An open-source skill memory layer for AI agents that captures learnings and stores them as agent skill files, enabling learning from mistakes and reuse of effective strategies.

Categories

Tags

Similar tools

Install

npm install Acontext

README

What is Acontext?

Acontext is an open-source skill memory layer for AI agents. It automatically captures learnings from agent runs and stores them as agent skill files — files you can read, edit, and share across agents, LLMs, and frameworks.

If you want the agent you build to learn from its mistakes and reuse what worked — without opaque memory polluting your context — give Acontext a try.

Skill is All You Need

Agent memory is getting increasingly complicated🤢 — hard to understand, hard to debug, and hard for users to inspect or correct. Acontext takes a different approach: if agent skills can represent every piece of knowledge an agent needs as simple files, so can the memory.

  • Acontext builds memory in the agent skills format, so everyone can see and understand what the memory actually contains.
  • Skill is Memory, Memory is Skill. Whether a skill comes from one you downloaded from Clawhub or one you created yourself, Acontext can follow it and evolve it over time.

The Philosophy of Acontext

  • Plain file, any framework — Skill memories are Markdown files. Use them with LangGraph, Claude, AI SDK, or anything that reads files. No embeddings, no API lock-in. Git, grep, and mount to the sandbox.
  • You design the structure — Attach more skills to define the schema, naming, and file layout of the memory. For example: one file per contact, one per project by uploading a working context skill.
  • Progressive disclosure, not search — The agent can use get_skill and get_skill_file to fetch what it needs. Retrieval is by tool use and reasoning, not semantic top-k.
  • Download as ZIP, reuse anywhere — Export skill files as ZIP. Run locally, in another agent, or with another LLM. No vendor lock-in; no re-embedding or migration step.

How It Works

Store — How skills get memorized?

flowchart LR
  A[Session messages] --> C[Task complete/failed]
  C --> D[Distillation]
  D --> E[Skill Agent]
  E --> F[Update Skills]
  • Session messages — Conversation (and optionally tool calls, artifacts) is the raw input. Tasks are extracted from the message stream automatically (or inferred from explicit outcome reporting).
  • Task complete or failed — When a task is marked done or fail