{"id":49534108,"url":"https://github.com/kittlabsai/kittynest","last_synced_at":"2026-05-02T09:04:11.894Z","repository":{"id":354223211,"uuid":"1222694966","full_name":"KittLabsAI/KittyNest","owner":"KittLabsAI","description":"Local-first memory tracker for Claude Code \u0026 Codex","archived":false,"fork":false,"pushed_at":"2026-04-29T14:56:00.000Z","size":8997,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T17:32:44.442Z","etag":null,"topics":["agent","claude-code","codex","llm","memory"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KittLabsAI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-27T16:04:47.000Z","updated_at":"2026-04-29T14:41:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/KittLabsAI/KittyNest","commit_stats":null,"previous_names":["yejiming/kittynest","kittlabsai/kittynest"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/KittLabsAI/KittyNest","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KittLabsAI%2FKittyNest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KittLabsAI%2FKittyNest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KittLabsAI%2FKittyNest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KittLabsAI%2FKittyNest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KittLabsAI","download_url":"https://codeload.github.com/KittLabsAI/KittyNest/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KittLabsAI%2FKittyNest/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32528665,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","claude-code","codex","llm","memory"],"created_at":"2026-05-02T09:04:11.093Z","updated_at":"2026-05-02T09:04:11.885Z","avatar_url":"https://github.com/KittLabsAI.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# KittyNest\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/kittynest-ui-concept.png\" alt=\"KittyNest UI Concept\" width=\"800\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eLocal-first memory tracker for Claude Code \u0026 Codex\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README_ZH.md\"\u003e简体中文\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nKittyNest is a **local-first, privacy-centric macOS desktop application** that helps you track, organize, and make sense of your AI coding sessions from [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) and [Codex](https://openai.com/index/openai-codex/). All your data stays on your machine — sessions are indexed locally in SQLite, and insights are stored as readable Markdown files.\n\n## ✨ Features\n\n- **🔍 Session Discovery** — Automatically scan and import sessions from Claude Code (`~/.claude`) and Codex (`~/.codex`)\n- **📁 Project Tracking** — Group sessions by working directory, review project health, and generate project summaries\n- **📝 Task Management** — Organize sessions into tasks with statuses (Discussing → Developing → Done)\n- **🧠 Memory System** — Three-tier cascading memory (Session → Project → System) with entity-relationship graph\n- **🤖 LLM-Powered Analysis** — Analyze sessions and projects using your own API keys (OpenAI-compatible, Anthropic-compatible, and more)\n- **📊 Dashboard** — At-a-glance view of active projects, open tasks, recent sessions, and memory status\n- **🔒 Local-First \u0026 Private** — All data stored in `~/.kittynest`; nothing leaves your machine unless you explicitly send it to your configured LLM provider\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  React Frontend (Vite + TypeScript)                         │\n│  Dashboard · Projects · Tasks · Sessions · Memories · Settings│\n└──────────────────────┬──────────────────────────────────────┘\n                       │ invoke\n┌──────────────────────▼──────────────────────────────────────┐\n│  Tauri 2 Shell                                              │\n│  macOS Window · Menu · File System Permissions · Lifecycle  │\n└──────────────────────┬──────────────────────────────────────┘\n                       │\n┌──────────────────────▼──────────────────────────────────────┐\n│  Rust Backend                                               │\n│  Commands · Adapters · Jobs · LLM Client · Markdown Store   │\n└──────────────────────┬──────────────────────────────────────┘\n        ┌──────────────┴──────────────┐\n        ▼                             ▼\n┌───────────────┐           ┌─────────────────────┐\n│  SQLite Index │           │  Markdown Store     │\n│  (local cache)│           │  ~/.kittynest/      │\n└───────────────┘           └─────────────────────┘\n```\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) 18+\n- [Rust](https://www.rust-lang.org/tools/install) 1.70+\n- macOS (primary target platform)\n\n### Development\n\n```bash\n# Install frontend dependencies\nnpm install\n\n# Run in development mode (opens Tauri window)\nnpm run tauri dev\n```\n\n### Build\n\n```bash\n# Build production bundle (.app and .dmg)\nnpm run tauri build\n```\n\nThe build artifacts will be located in `src-tauri/target/release/bundle/`.\n\n## 📂 Data Storage\n\nAll application data is stored locally under `~/.kittynest/`:\n\n```\n~/.kittynest/\n├── config.toml              # LLM provider settings\n├── kittynest.sqlite         # SQLite index database\n├── kittynest_graph.db       # Entity-relationship graph database\n├── projects/\n│   └── \u003cproject_slug\u003e/\n│       ├── info.md          # Project summary\n│       ├── progress.md      # Project progress\n│       └── \u003ctask_slug\u003e/\n│           ├── summary.md\n│           ├── user_prompt.md\n│           └── \u003csession\u003e.md\n└── memories/\n    ├── sessions/\n    │   └── \u003csession_slug\u003e/\n    │       └── memory.md\n    ├── projects/\n    │   └── \u003cproject_name\u003e.md\n    └── system/\n        └── memory.md\n```\n\n## ⚙️ Supported LLM Providers\n\nKittyNest supports a wide range of LLM providers via presets:\n\n- OpenRouter\n- DeepSeek\n- Zhipu GLM\n- Bailian\n- Kimi (Moonshot)\n- StepFun\n- MiniMax\n- DouBao (Seed)\n- ModelScope\n- Ollama (local)\n- OpenAI-compatible APIs\n\nYou can configure your provider in the **Settings** page.\n\n## 🛠️ Tech Stack\n\n| Layer | Technology |\n|-------|------------|\n| Frontend | React 18, TypeScript, Vite |\n| Desktop Shell | Tauri 2 |\n| Backend | Rust |\n| Database | SQLite (rusqlite) |\n| Graph DB | CozoDB (SQLite-backed) / Pure SQLite fallback |\n| UI Components | Lucide React, XYFlow |\n| Styling | Custom CSS |\n\n## 🗺️ Roadmap\n\n- [x] Project skeleton \u0026 configuration\n- [x] Claude Code / Codex source adapters\n- [x] Project tracking \u0026 manual review\n- [x] Historical session batch analysis\n- [x] Incremental session scanning\n- [x] Memory module (Session / Project / System)\n- [x] Task creation \u0026 management\n- [x] Settings page \u0026 LLM configuration\n- [x] macOS desktop integration\n- [ ] Graph query UI\n- [ ] Memory versioning \u0026 rollback\n- [ ] Auto-updater\n- [ ] Apple Silicon optimization\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit issues or pull requests.\n\n## 📄 License\n\n[MIT](LICENSE)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Built with ❤️ for local-first AI session management\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkittlabsai%2Fkittynest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkittlabsai%2Fkittynest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkittlabsai%2Fkittynest/lists"}