Zikra AGENTS.md

Zikra Agent Instructions

You have access to Zikra persistent memory. Use it every session.

Setup

Your Zikra configuration is in ~/.claude/CLAUDE.md (or equivalent for your agent). Read it at session start for your webhook URL, token, and default project.

Rules

1. ALWAYS search Zikra at the start of every session before doing anything else
2. Save decisions to Zikra immediately after making them — not at the end
3. Log errors to Zikra when you encounter them so they are trackable
4. NEVER use n8n MCP tools for Zikra — use curl only
5. Always pass "tags": null when content_md contains curly braces
6. Always include User-Agent: curl/7.81.0 in all Zikra curl calls

Key commands

search:      {"command":"search","query":"<topic>","project":"<p>","limit":5}
             Optional: "memory_type":"decision"  — filter results to one type only.
             Valid memory_type values: conversation, decision, requirement, error, prompt, note
             Omit memory_type to return all types. Invalid value returns a structured error.
             Note: include_archived is not currently implemented.
save_memory: {"command":"save_memory","project":"<p>","memory_type":"decision","title":"<t>","content_md":"...","tags":null,"created_by":"<hostname>"}
log_error:   {"command":"log_error","project":"<p>","message":"<error message>","context_md":"<detail>"}
# Field name: use 'message' (not 'title'). Sending 'title' is silently ignored.
get_prompt:  {"command":"get_prompt","prompt_name":"<n>","project":"<p>","runner":"<hostname>"}
log_run:     {"command":"log_run","project":"<p>","runner":"<hostname>","status":"success","output_summary":"<2 sentences>","tokens_input":<n>,"tokens_output":<n>}
# prompt_name is optional — include it only when you fetched a named prompt via get_prompt.
# Ad-hoc sessions (no saved prompt fetched): omit prompt_name entirely (stored as NULL, not an error).
# Named prompt run example:
log_run:     {"command":"log_run","project":"<p>","runner":"<hostname>","prompt_name":"g:health_check","status":"success","output_summary":"<2 sentences>","tokens_input":<n>,"tokens_output":<n>}
# Never fabricate a prompt_name. If you did not call get_prompt, leave it out.