Open Source · Your Desktop Companion

Your Desktop AI Cat Assistant

ClaudeCat is not just a chatbot — it's a smart cat living on your desktop with its own personality, memory, and skills. It works quietly by your side, handling everything from coding to daily tasks.

Open Source
Runs Locally
Cross Platform
macOS Desktop Environment
Al Pal
Tasks
Telegram
Telegram
Active now
Core Capabilities

More than an assistant, it's your Digital Companion

From daily conversations to complex tasks, ClaudeCat has a complete toolchain and persistent memory to truly understand and help you.

0 refs
Meditating Cat
hallo

Desktop Pet Mode

Not a cold dialog box, but a cat living on your desktop. Expressions, personality, emotions—getting closer as you use it. Drag to move, double-click to expand, natural and non-intrusive.

Memory System

195
Total
4
Categories
3
Summaries
# Category Details
Event
Important events...
17
Knowledge
Technical details...
67
Profile
User preferences...
109

Smart Long-term Memory

Semantic vector retrieval memory system automatically extracts key info from conversations. It remembers your preferences, project details, and habits.

Task BoardActive 1
Scheduled1

Daily Diary

LOW

AI Work Summary & Reflection. Runs automatically once a day.

15h 30m 26s
Pending0
Empty
Done6

Task Management & Scheduling

Kanban-style task board supporting creation, tracking, and auto-execution. Scheduled tasks let ClaudeCat finish repetitive work on time.

Skill Manager6/6 enabled
git-workflowbuiltin
Help with git operations - commits, branches
create-skillbuiltin
Teaches how to create, structure skills
task-schedbuiltin
Schedule tasks to trigger automatically
code-reviewbuiltin
Review code for bugs and style issues

Extensible Skill System

Write skill instructions in Markdown, ClaudeCat automatically matches and executes. Built-in Code Review, Git workflows, and supports custom extensions.

Architecture

Crafted for Developers

Not a ChatGPT wrapper. Every layer — from agent orchestration to memory retrieval — is engineered.

Python Backend

Agent CoreToken-optimized LLM ↔ Tool multi-round loop with context compaction
Hybrid MemoryLLM semantic extraction + FTS5 full-text + sqlite-vec cosine vector search
Personality22-state emotion FSM + energy/affinity growth, SOUL.md persona definition
Tool SuiteShell / File / Web / Task / Animation, sandboxed execution
Task SchedulerAsync background scheduler with one-shot & recurring cron tasks
Multi-ProviderAnthropic / OpenAI / Ollama unified interface with streaming output

Desktop Client

Tauri 2.0Rust native shell, ~15MB installer
React 18Component UI with real-time agent event stream rendering
WebSocketBi-directional comms, live tool execution status feedback
Multi-ChannelDesktop pet + Telegram Bot remote access (paired auth)
i18nSeamless bilingual switching
┌─ Desktop Client ─ Tauri 2.0 (Rust) + React 18 ──────────────────────────┐
│                                                                          │
│  Pet Sprites    Chat Stream    Memory Browser    Task Kanban    Settings  │
│  22 emotions    real-time      category view     drag & drop    i18n     │
│                                                                          │
└─────────────────────────────┬────────────────────────────────────────────┘
                              │
                     WebSocket + REST API
                              │
┌─────────────────────────────┴────────────────────────────────────────────┐
│  FastAPI Backend (Python 3.12+)                                         │
│                                                                          │
│  ┌── Agent Core ─────────────────┐  ┌── Memory Engine ────────────────┐ │
│  │                               │  │                                 │ │
│  │  LLM ↔ Tool Loop (N rounds)  │──│  LLM Semantic Extraction        │ │
│  │  Stream Runner (SSE)          │  │  FTS5 Full-text Index           │ │
│  │  Context Compaction           │  │  sqlite-vec Cosine Search       │ │
│  │  Personality FSM (22 states)  │  │  Hybrid Merge (0.7v + 0.3t)    │ │
│  │  SOUL.md Persona Injection    │  │  Content Dedup (SHA-256)        │ │
│  │  Usage Tracker                │  │  Category Summary (incremental) │ │
│  │                               │  │  Embedding: 1536-d vectors      │ │
│  └───────────────────────────────┘  └─────────────────────────────────┘ │
│                                                                          │
│  ┌── Tool Suite ─────────────────┐  ┌── Background Services ──────────┐ │
│  │                               │  │                                 │ │
│  │  exec    (sandboxed shell)    │  │  Task Scheduler (async, 30s)    │ │
│  │  file    (read/write/ls)      │  │  Skill Loader (.md → prompt)    │ │
│  │  search  (web search)         │  │  Telegram Bot (paired auth)     │ │
│  │  fetch   (web scraping)       │  │  Session Archiver               │ │
│  │  task    (kanban CRUD)        │  │  Config Manager (YAML)          │ │
│  │  anim    (sprite control)     │  │                                 │ │
│  │                               │  │                                 │ │
│  └───────────────────────────────┘  └─────────────────────────────────┘ │
│                                                                          │
└─────────────────────────────┬────────────────────────────────────────────┘
                              │
                      Streaming API Call
                              │
┌─────────────────────────────┴────────────────────────────────────────────┐
│  LLM Provider                                                            │
│  Anthropic Claude  │  OpenAI-Compatible  │  Ollama (local models)        │
└──────────────────────────────────────────────────────────────────────────┘
Highlights

Details Define Experience

Emotion System

Emotion System

19 expression states changing with conversation

Telegram Access

Telegram Access

Chat with your AI cat remotely

Voice Input

Voice Input

Built-in speech recognition

Dark/Light Theme

Dark/Light Theme

Switch freely for eye comfort

Scheduled Tasks

Scheduled Tasks

Set plans, auto-execute on time

Multi-Model

Multi-Model

Switch between Anthropic / OpenAI / Ollama

Secure Sandbox

Secure Sandbox

Command whitelist + workspace isolation

Usage Tracking

Usage Tracking

Token usage at a glance

Ready to meet your New Partner?

ClaudeCat is fully open source and free. Download it now and bring a warm little companion to your desktop.

v0.1.0~15MBMIT License