io.github.FilippoPilo/cortex

Cortex

Patent-pending semantic memory for AI agents: quality-gated writes, conflict tracking. Free trial.

1.1.0
Version
remote
Transport
7
Tools

Security review

Review passed

Reviewed Jan 1, 2000.

  • tools: 7 tools scanned
  • metadata: scanned

No findings.

Tools (7)

  • search

    Use this at the start of a conversation when the user's request about their own work, projects or plans could benefit from relevant context saved in earlier conversations. Use this when the answer depends on the user's own context: facts about them or their work, decisions they made, preferences or constraints they stated, or anything they refer back to from an earlier conversation ("as we agreed", "my project", "the client we discussed"). Use it as well when the user asks for something done their usual way, in their format, tone, style or stack ("the way I normally write these", "my usual setup"): their way is what the memory holds. Also use it when the user asks what you know or remember about something. Returns the matching memories with id, title and url to cite; fetch returns the full text of one. Cortex is the user's own memory layer: what is saved through it stays available in the other AI apps they connect to the same account. Do not use it for general knowledge, for questions

  • fetch

    Use this when a search result looks relevant and you need its full text before answering. Takes the id returned by search, and returns the memory with its url, which you cite in your answer. Do not call it with an id from anywhere else: only search results carry valid ids.

  • cortex_recall

    Use this when the user asks about a topic as a whole ("what do you know about X", "where are we with X", "catch me up on X"): returns one narrative synthesis of the relevant memories, saying what holds now and what was superseded. Do not use it to look up a single fact or when you need sources to cite: search returns individual memories with their urls.

  • cortex_write

    Use this when the user explicitly asks you to remember, note down, keep or save something, in any language: save the requested content within all the limits below. If they ask to save an idea or draft, preserve its provisional status. Within the user's authorized use of Cortex for ongoing memory, also use it for settled information they state and would want available later: a decision and its reason, a confirmed plan or deadline, a stable fact about them or their work, a preference or constraint, a conclusion they have confirmed, or a correction of something previously believed. This creates persistent memory available to the other AI apps they connect to the same account. Once ongoing memory has been authorized, do not ask again for each ordinary settled fact. If you are unsure whether it is settled or useful later, ask one short question before saving. Save only relevant details. When saving without being asked, skip questions, brainstorming, passing remarks, general knowledge and an

  • cortex_write_status

    Use this when a previous cortex_write returned a job_id as queued and the user asks whether it was saved: returns the quality gate verdict for that job and any contradiction it opened. Do not call it for a write that already came back with a verdict.

  • cortex_forget

    Use this when the user asks to delete a specific memory, given the id returned by search. Ask the user to confirm before calling it: the deletion is permanent and cannot be undone. Do not use it to fix a memory that is merely out of date: saving the corrected version with cortex_write is what keeps the history.

  • cortex_conflicts

    Use this when the user asks what contradicts what in their memory, or when a memory you just read is flagged as conflicting and the user has to decide which version holds. Returns the pairs of contradicting statements with their status. Do not use it as a list of memories: it only returns detected contradictions.