agentmem 0.1.1

Local-first memory engine for AI coding agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

# AgentMem

Local-first memory infrastructure for AI agents. AgentMem gives tools like Claude, Codex, Gemini, OpenClaw, Hermes, local coding agents and autonomous scripts a structured way to persist memory between runs.

Instead of losing context every session or scattering state across JSON files, temp folders, prompts, and shell history, AgentMem provides a clean shared memory layer.

---

# Why AgentMem Exists

Most AI tools today are stateless.

That means they repeatedly need to rediscover:

- what project this is
- where files live
- coding conventions
- current task status
- prior fixes
- known bugs
- open decisions
- team notes

That wastes:

- tokens
- time
- API cost
- focus
- context window space

AgentMem fixes that.

---

# Core Benefits

## Persistent Memory

Store useful project context between sessions.

## Local-First

Your memory stays on your machine.

## Fast CLI

Simple commands that agents and humans can both use.

## Structured Namespaces

Organize memory cleanly.

```text
agent/claude/current_task
project/demo/stack
repo/build_command
bugs/auth/login
```

######################################
##      Installation + Setup        ##
######################################

```bash
# install globally
cargo install agentmem

# verify install
agentmem --help

# go to your project
cd my-project

# initialize project memory and index codebase
agentmem init
agentmem index
# use re-index after changes to codebase
agentmem reindex

# store memory
agentmem set project/name "My Project"
agentmem set repo/stack "Next.js + TypeScript"
agentmem set project/current_goal "Ship billing v2"
agentmem set agent/claude/current_task "Fix auth bug"

# read memory
agentmem get project/name
agentmem get agent/claude/current_task

# list everything
agentmem list
```

######################################
##              Examples            ##
######################################

cd my-nextjs-app

agentmem init
agentmem set repo/stack "Next.js + Supabase"
agentmem set project/current_goal "Launch payments"
agentmem set agent/claude/current_task "Fix checkout bug"
agentmem get project/current_goal