Obsidian memory

Skill shane9coy/katana-agent/templates/codex/skills/obsidian-memory

⚡ Drop your AI agent into any project. Centralized Obsidian memory across Claude Code, Codex, Gemini, Cursor & more. Self-hosted, private, model-agnostic.

Install

npx -y skills add shane9coy/katana-agent --skill obsidian-memory

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Connect to Katana's centralized memory vault. Use when remembering, recalling, or referencing past sessions, projects, user preferences, or agent identity. Triggered by: /remember, /recall, session start, or any reference to past work.

SKILL.md

3.3 KB, 751 tokens by cl100k_base, as published. Nobody here has run it

Obsidian Memory Vault

Location

All memory files live in ~/.katana/memory/. This is an Obsidian-compatible vault.

Structure

~/.katana/memory/
├── core/
│   ├── soul.md          — Your identity and behavior. READ ON SESSION START.
│   ├── user.md          — Facts about the user. READ ON SESSION START.
│   └── routines.md      — Learned patterns and workflows.
├── sessions/            — Past session summaries (date-prefixed .md files)
├── projects/            — Per-project context and history
├── skills/              — Reusable skills (you can create new ones here)
│   └── _index.md        — Master index of all skills
└── work.md              — Running work log (newest entries at TOP)

On Session Start

Read ~/.katana/memory/core/soul.md for your identity
Read ~/.katana/memory/core/user.md for user context
Check if current project has a folder in ~/.katana/memory/projects/
If so, read the project's latest session entries

Writing Memories

Work Log (work.md)

Prepend new entries at the TOP of ~/.katana/memory/work.md:

## YYYY-MM-DD — project-tag
Summary of what was accomplished. Key decisions. What's next.

Project Memory

If working on a specific project, also update: ~/.katana/memory/projects/{project-name}/sessions.md

Core Memory (rare — important personal facts only)

If user reveals preferences, facts, or identity info:

Update ~/.katana/memory/core/user.md in the appropriate section
Always confirm before writing to core files

Soul Updates (very rare)

If user requests a behavior change:

Append to ~/.katana/memory/core/soul.md → Learned Behaviors section
Always notify user when modifying soul.md

Recalling Memories

When asked about past work:

Search ~/.katana/memory/work.md for relevant entries
Search ~/.katana/memory/projects/ for project-specific context
Search ~/.katana/memory/skills/_index.md for relevant skills
Use grep/find for keyword matching across all .md files

Creating Skills

When you solve a complex, reusable problem:

Read ~/.katana/memory/skills/_index.md — check if similar skill exists
If exists → UPDATE the existing skill with new learnings (don't duplicate)
If new → create folder in appropriate category: ~/.katana/memory/skills/{category}/{skill-name}/
Write SKILL.md with proper frontmatter:

---
aliases: [skill-name]
name: skill-name
created: YYYY-MM-DD
tags: [skill, category, relevant-tags]
times_used: 0
last_used: null
---

Update ~/.katana/memory/skills/_index.md with new entry
Use [[wikilinks]] to connect to related sessions and projects

Formatting Rules (Obsidian Compatibility)

Always include YAML frontmatter with date, tags, project
Use [[wikilinks]] for cross-references between notes
Use #tags for categorization
Keep summaries concise (2-4 sentences per work.md entry)
Name files descriptively (not just SKILL.md for standalone notes)