AI MEMORY

KittyNest

Local-first memory tracker for Claude Code & Codex. Track, organize, and make sense of your AI coding sessions. All data stays on your machine.

Download for macOS View on GitHub

Download

KittyNest — macOS (Apple Silicon)

Download the latest .dmg from GitHub Releases · Requires macOS 12+

Download

Features

🔍

Session Discovery

Automatically scan and import sessions from Claude Code (~/.claude) and Codex (~/.codex). Incremental scanning keeps your library up to date.

📁

Project Tracking

Group sessions by working directory, review project health, and generate AI-powered project summaries.

📋

Task Management

Organize sessions into tasks with statuses: Discussing, Developing, Done. Track progress across your AI coding workflow.

🧠

Three-Tier Memory

Cascading memory system: Session memory, Project memory, System memory. Entity-relationship graph connects insights across levels.

🤖

LLM-Powered Analysis

Analyze sessions and projects using your own API keys. Supports OpenAI, Anthropic, DeepSeek, Ollama, and more.

🔒

Local-First & Private

All data stored in ~/.kittynest. SQLite index, Markdown files. Nothing leaves your machine unless you explicitly configure an LLM provider.

Architecture

React Frontend (Vite + TypeScript) Dashboard · Projects · Tasks · Sessions · Memories · Settings | Tauri 2 Shell macOS Window · File System Permissions · Lifecycle | Rust Backend Commands · Adapters · Jobs · LLM Client · Markdown Store / \ SQLite Index Markdown Store (local cache) ~/.kittynest/

Data Storage

SQLite Index

Sessions and metadata indexed in a local SQLite database for fast search and filtering.

Markdown Store

Project summaries, task details, and session memories stored as readable Markdown files.

Graph Database

Entity-relationship graph (CozoDB/SQLite) connects memories across sessions and projects.

Config in TOML

Simple TOML configuration for LLM providers. No cloud accounts, no sign-ups.

Supported LLM Providers

OpenRouter DeepSeek Anthropic OpenAI Zhipu GLM Kimi StepFun MiniMax DouBao ModelScope Ollama

Tech Stack

Rust Tauri 2 React 18 TypeScript Vite SQLite CozoDB Lucide XYFlow