Skip to main content

Ankora

Tiny persistent memory for coding agents. Save atomic notes as plain markdown; recall the relevant ones when you start a new session — so the agent continues instead of forgetting what you already worked out.

The problem

Everyone's fix for "Claude forgets" is a bigger CLAUDE.md. But bigger context makes it worse, not better — long files get diluted and the model loses the middle. Splitting into tree.md / context.md / structure.md only helps if you stop loading them all every session; four growing files that always load are the same wall in four pieces.

Ankora is the small version of the fix: one atomic note per fact/decision, a tiny always-loaded index, pull in only the note the task needs.

Install

Needs Python 3.8+ and nothing else — no dependencies to pull in, nothing to build.

pip install ankora-memory
ankora --help

The PyPI name is ankora-memory because plain ankora was already taken by an unrelated project; the command you actually type is still ankora.

Or skip the install entirely — it's one file, so you can just run it:

git clone https://github.com/JavaB1/ankora
cd ankora
python ankora.py --help

Use

# save a decision
ankora save "Use UUID v7 for ids" -t decision -g db,ids -m "time-ordered, index-friendly, avoids v4 fragmentation"

# recall what's relevant to the task at hand
ankora recall "uuid ids"

# rebuild the index (one line per anchor)
ankora index

(Running from a clone instead of an install? Use python ankora.py ... — same commands.)

Anchors live in ./.ankora/anchors/*.md — plain markdown with a small frontmatter block, so they diff cleanly in git and you can read/edit them by hand. ./.ankora/INDEX.md is the short always-on list.

Set ANKORA_DIR to point it somewhere else (e.g. a shared notes repo).

Writes are atomic and guarded by a lock, so a crash mid-save or two concurrent saves never silently lose an anchor.

With Claude Code

Drop SKILL.md into your project (or .claude/skills/). It tells the agent to run recall at the start of a session and save when a real decision is made. See SKILL.md.

What it does NOT do (on purpose)

This is deliberately small. It does not do embeddings/semantic search, a graph, auto-consolidation, conflict detection, or ranking beyond weighted whole-word keyword matching. If two notes disagree, both stay — you resolve it. If you outgrow keyword recall, that's when a full memory framework is worth the extra setup. Ankora is the small version that covers most of the value first, with nothing to install.

License

MIT. Use it, fork it, ship it.

Metadata

Release files for ankora-memory 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ankora-memory 0.2.0
File Size Uploaded Provenance Actions
ankora_memory-0.2.0.tar.gz 7.8 kB Without provenance Details for ankora_memory-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ankora-memory 0.2.0
File Interpreter ABI Platform Actions
ankora_memory-0.2.0-py3-none-any.whl Python 3 none any Details for ankora_memory-0.2.0-py3-none-any.whl

Total release size: 16.0 kB

Release files / ankora_memory-0.2.0.tar.gz

Download URL ankora_memory-0.2.0.tar.gz
Size 7.8 kB
Tags Source
SHA-256 checksum
How to use checksums
dfdb98c12d9b7fa356267498938f8bb95e56dd6bcc2145d1590d8eb20fb202ad
BLAKE2b-256 checksum
How to use checksums
7ace10c9f7905f604899b25191bf76d80e669dd058ad7167b706e9d7dacc13b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.0

Release files / ankora_memory-0.2.0-py3-none-any.whl

Download URL ankora_memory-0.2.0-py3-none-any.whl
Size 8.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3aa0b0761434296465909ee811e3657f357ef74ce58e357f2329e738c7953d4c
BLAKE2b-256 checksum
How to use checksums
49fe5727310e1c7c98d30a4ac3529a276dafb4306dd2b6ff2b4d97c3b9fb7469
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.0

Security for ankora-memory 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page