Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
C

claude-os

> 编程语言
Open source

Claude OS Give Your AI a Memory Claude Code that actually remembers you. --- ✨ The Magic You: "Remember this: our API uses JWT tokens with …

394 stars0 likes0 views
WebsiteGitHub

About

Claude OS Give Your AI a Memory Claude Code that actually remembers you. --- ✨ The Magic You: "Remember this: our API uses JWT tokens with …

Claude OS

Give Your AI a Memory

Claude Code that actually remembers you.


✨ The Magic

You: "Remember this: our API uses JWT tokens with 15-minute expiry and 7-day refresh tokens"

Claude: Saved: "API Authentication Strategy" (Architecture)

That's it. Next week, next month, next project - Claude remembers. No commands to memorize. No complex setup. Just talk naturally.

"remember this..."     → saved to your knowledge base
"what did we decide?"  → searches your memories
"how did we fix that?" → finds past solutions

Every conversation makes Claude smarter. Every insight builds your shared knowledge.


What's New in v2.5

Latest Release: February 2026

Cross-KB Search

Search across all your knowledge bases at once with a single query!

mcp__code-forge__search_all_knowledge_bases
  query: "authentication patterns"
  kb_filter: "MyProject-"          # optional: limit to one project's KBs
  • Results merged by relevance score with KB attribution
  • Automatic deduplication across KBs
  • Optional prefix filter to scope by project
  • New API endpoint: POST /api/kb/search-all

Inline Health Checks

Health checks now run automatically during search — no manual invocation needed.

  • When you search a KB, Claude OS checks if a health report has been run in the last 24 hours
  • If stale, runs a quick health check and appends HIGH/CRITICAL warnings to the search result
  • Cached in data/health_cache.json — never slows down or breaks search
  • Look for _health_warnings in search results

Simplified Session Management

Session state reduced from a 50-field JSON blob to 4 fields:

json
{
  "last_task": "Fix appointment email flood",
  "last_branch": "fix-email-flood",
  "stopped_at": "2026-02-06T18:30:00Z",
  "one_liner": "Fixed dedup check, still need rate limiting"
}
  • START: read state, show one-liner, search memories, ready
  • END: git diff summary, offer to save, write state
  • save, blocker, pattern sub-commands unchanged

Leaner CLAUDE.md Template

Project CLAUDE.md template cut from 351 to 128 lines:

  • Removed 200-line mandatory session protocol (6-phase startup, ASCII prompts)
  • Replaced with 4-line "Session Tips" section
  • Project content first, Claude OS section second
  • All template variables preserved

Recent Improvements

Version Highlights
v2.5 Cross-KB search, inline health checks, simplified sessions, leaner templates
v2.4 Knowledge lifecycle engine (dedup, consolidate, archive, health)
v2.3 Skills library, community skills, session insights
v2.2 Gum CLI support, safety features, lite model default
v2.1 Unified installer, OpenAI provider support
v2.0 Hybrid tree-sitter indexing, real-time Kanban board

Community Contributions

Thanks to our amazing contributors!

PR Contributor Description
#22 @illAssad Fix delete document endpoint SQLite cursor handling
#21 @illAssad Skip node_modules and build directories during ingestion
#20 @illAssad Fix tree-sitter version compatibility
#19 @illAssad Add non-blocking semantic indexing with Jobs Dashboard UI
#18 @illAssad Fix frontend startup by auto-installing npm dependencies
#17 @williamclavier Fix: Ensure commands/skills directories exist
#16 @jplimack Fix hardcoded paths - make dynamic
#12 @gkastanis Add missing frontend lib files
#11 @gkastanis Add Linux support for installation
#10 @nicseltzer Fix broken README link

What is Claude OS?

Claude OS isn't just a tool - it's Claude's memory.

Think about it: you and Claude work together on a feature. You explain your architecture, your patterns, your preferences. Then you close the terminal... and it's all gone. Tomorrow, you start over.

What if Claude actually remembered?

Before Claude OS

Day 1: "We use JWT tokens with refresh..."
Day 2: "As I mentioned, we use JWT tokens..."
Day 3: "Again, the auth system uses JWT..."

After Claude OS

Day 1: "Remember this: we use JWT tokens with refresh..."
Day 2: Claude already knows. Applies the pattern automatically.
Day 3: Claude suggests improvements based on what worked.

The Difference

Without Claude OS With Claude OS
Explain the same things repeatedly Claude remembers your decisions
Start cold every session Context loaded automatically
Patterns forgotten Patterns compound over time
Claude is a tool Claude is a partner

Why It Works

  • Persistent Knowledge - Decisions, patterns, solutions saved across sessions
  • Automatic Recall - Relevant memories surface when you need them
  • Documentation Search - Your docs indexed and searchable via RAG
  • Session Learning - Claude extracts insights from past conversations
  • 100% Local - Your knowledge never leaves your machine

Features at a Glance

Feature What It Does
Natural Language Memory Just say "remember this" - no commands needed
Session Insights Auto-extracts patterns from past conversations
Lightning Indexing 10,000 files indexed in 30 seconds
Skills Library 36+ community skills, one-click install
Cross-Project Learning Patterns from Project A help in Project B
Knowledge Lifecycle Dedup, consolidate, archive, and health reports
One-Command Setup /claude-os-init and you're ready

⚡ NEW: Hybrid Indexing System

Claude OS v2.0 introduces lightning-fast tree-sitter based indexing!

The Problem with Traditional Indexing

Previous versions embedded EVERY file, which was painfully slow for large codebases:

  • Large projects (10,000+ files): 3-5 hours to index
  • Must complete before Claude can start working
  • High resource usage, blocks productive coding

The Solution: Hybrid Two-Phase Indexing

Inspired by Aider's approach, Claude OS now uses:

Phase 1: Structural Index (30 seconds)

  • ⚡ Parse files with tree-sitter (no LLM calls!)
  • Extract symbols only (classes, functions, signatures)
  • Build dependency graph
  • PageRank importance scoring
  • ✅ Ready to code immediately!

Phase 2: Semantic Index (optional, background)

  • Selective embedding (top 20% most important files)
  • Full embedding for documentation
  • Deep semantic search when needed
  • ⏰ Runs in background while you code

Performance Comparison

Feature Before After (Hybrid)
Large project (10k files) 3-5 hours 30 seconds + 20 min optional
Files embedded 100,000+ chunks ~20,000 chunks (80% reduction)
Start coding After full index Immediately!
Resource usage High Ollama load Minimal CPU/memory
Query speed Semantic search Instant structural + semantic

Read the full design: docs/HYBRID_INDEXING_DESIGN.md


Visual Interface

Claude OS provides a beautiful, intuitive web interface for managing your AI development workflow:

Welcome Screen

Get started with Claude OS

Project Overview

View project details and MCP status

Kanban Board

Track spec implementation progress

Services Dashboard

Monitor all Claude OS services

** See the complete visual guide:** docs/guides/VISUAL_GUIDE.md


️ Architecture Overview

Claude OS is built on 5 core pillars that work together to give Claude persistent memory:

  1. ** Real-Time Learning** - Automatically captures insights from conversations via Redis Pub/Sub
  2. ** Memory MCP** - Persistent memory system with instant recall using natural language
  3. ** Analyze-Project** - Intelligent codebase indexing with git hooks and tree-sitter
  4. ** Session Management** - Auto-resume sessions with full context preservation
  5. ** Semantic Search** - Vector-based code understanding and pattern recognition

All knowledge flows through the Semantic Knowledge Base (SQLite + sqlite-vec), exposed via the MCP Server (port 8051) to Claude Code, giving you an AI assistant that never forgets.

Data Flow: Git Commit → 3s indexing → SQLite → MCP → Claude → You


Installation & Setup

Prerequisites

Required:

  • macOS or Linux (Ubuntu, Debian, Fedora, RHEL, Arch)
  • Python 3.11 or 3.12 (python3 --version)
    • Note: Python 3.13+ not yet supported due to dependency constraints
  • Git (git --version)

Optional:

  • Node.js 16+ (for React UI)
  • Ollama (for local AI) or OpenAI API key

Note: Windows support coming soon.

Quick Installation

bash
# Clone the repository
git clone https://github.com/brobertsaz/claude-os.git
cd claude-os

# Run the unified installer
./setup-claude-os.sh

First time? Try the demo first:

bash
./setup-claude-os.sh --demo    # See the beautiful UI (no changes made)
./setup-claude-os.sh --dry-run # Preview what would be installed

The installer will guide you through:

  1. Choose Provider: Local (Ollama) or Cloud (OpenAI)
  2. Choose Model Size: Lite (2GB) or Full (4.7GB) - for local installs
  3. Automatic Setup: Python, dependencies, MCP server, commands/skills

What gets installed:

  • ✅ Python virtual environment
  • ✅ All dependencies
  • ✅ MCP server configuration
  • ✅ Commands and skills symlinked to ~/.claude/
  • ✅ Ollama + models (if local provider selected)
  • ✅ Redis for caching

Installer Options

bash
./setup-claude-os.sh           # Interactive installation
./setup-claude-os.sh --demo    # Try the UI without changes
./setup-claude-os.sh --dry-run # Preview what would happen
./setup-claude-os.sh --help    # Show all options
./setup-claude-os.sh --version # Show version

Legacy Scripts

The old install.sh and setup.sh scripts still work - they redirect to the new unified installer.

Visit to use the web UI.

Starting Claude OS

After installation, start the services:

bash
./start.sh

This starts the MCP server at http://localhost:8051


Quick Start

Initialize any project with Claude OS in under 2 minutes:

Step 1: Navigate to Your Project

bash
cd /path/to/your/project

Step 2: Initialize with Claude OS

In Claude Code, run:

/claude-os-init

The command will:

  1. Ask Questions Interactively:

    • Project name (auto-detects from folder)
    • Tech stack (Ruby on Rails, Python, Node.js, etc.)
    • Database (PostgreSQL, MySQL, etc.)
    • Development environment (Docker, Local, etc.)
    • Brief description
    • Documentation directory to ingest (optional)
  2. Create Project in Claude OS:

    • Calls API to create project
    • Creates 4 knowledge bases automatically:
      • {project}-project_memories - Claude's memory
      • {project}-project_profile - Architectur

Issues· 5 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Python

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言