Zikra — AI Persistent Memory

# Zikra — AI Persistent Memory

Zikra gives you cross-session, cross-machine, cross-agent memory backed by
PostgreSQL + pgvector. Search, save, and retrieve decisions, errors, and context.

## Install

```bash
curl -fsSL https://zikra.dev/install.sh | bash
```

## When to use

- Start of every session — search for relevant context before starting work
- After key decisions — save a decision memory immediately
- On errors — log the error so it is trackable and searchable
- End of session — log_run fires automatically via hook

## Commands

**Search memories:**
```bash
curl -s -X POST $ZIKRA_URL \
  -H "Authorization: Bearer $ZIKRA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command":"search","query":"your topic","project":"yourproject"}'
```

**Save a memory:**
```bash
curl -s -X POST $ZIKRA_URL \
  -H "Authorization: Bearer $ZIKRA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command":"save_memory","project":"yourproject","memory_type":"decision",
       "title":"your title","content_md":"your content","tags":null,
       "created_by":"hostname"}'
```

**Log an error:**
```bash
curl -s -X POST $ZIKRA_URL \
  -H "Authorization: Bearer $ZIKRA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command":"log_error","project":"yourproject",
       "message":"what broke","context_md":"what happened and why"}'
```

## Memory types

- **decision** — architectural and design choices
- **conversation** — session diary entries (auto-generated by hooks)
- **error** — bugs and failures for tracking
- **schema** — database and API schemas
- **prompt** — reusable agent prompts