Skip to content

SKILL.md

Latest commit

 

History

History
54 lines (43 loc) · 1.6 KB

SKILL.md

File metadata and controls

54 lines (43 loc) · 1.6 KB
Raw

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

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:

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:

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:

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