Add KB lifecycle management system with deduplication, consolidation,
archival, and health analytics. Also fix pre-existing routing bug in
upload_document MCP tool (was hitting /import instead of new /documents/content).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Memory Skill:
- Merged remember-this into unified memory skill
- Now uses Claude OS KBs (not separate memory MCP)
- Supports natural language: "remember this:", "save to memory:", etc.
- Deleted redundant remember-this skill
README:
- New tagline: "Give Your AI a Memory"
- Added "The Magic" section showing natural language UX
- Rewrote "What is Claude OS" with before/after comparison
- Added killer line: "Claude is a tool → Claude is a partner"
- Compact features table replacing wall of checkmarks
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add Discord badge and invite link at top of README
- Add 5 new PRs from @illAssad (#18-#22) to contributions table
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add OS and package manager detection (apt, dnf, yum, pacman)
- Skip installation if Ollama/Redis already installed
- Use direct daemon execution instead of sudo for service start
- Update help messages with Linux package manager instructions
- Update README to reflect Linux support
Tested on Ubuntu with apt and systemctl.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Consolidated duplicate architecture sections by removing the ASCII
architecture diagram section (lines 649-688) while keeping the
comprehensive Architecture Overview section with SVG diagram.
The Template System section has been promoted to its own top-level
section for better organization.
This commit fixes several critical issues found during comprehensive review:
## CRITICAL FIX: Template Consolidation ⚠️
- Moved 6 commands from ~/.claude/commands/ to templates/commands/
- Moved 3 skills from ~/.claude/skills/ to templates/skills/
- Team sharing was BROKEN without this (symlinks pointed to empty dirs)
- Updated README with prominent consolidation step warning
- Commands: list, remember, save, search, session, triggers
- Skills: initialize-project, remember-this, memory
## HIGH PRIORITY FIXES:
- ✅ Completed selective semantic indexing (removed TODO at line 878)
- ✅ Fixed PostgreSQL references in health check (system uses SQLite)
- ✅ Created comprehensive API documentation (docs/API_REFERENCE.md)
- ✅ Added Depends import to fix authentication endpoints
## DOCUMENTATION:
- Added complete API_REFERENCE.md (60+ endpoints documented)
- Created HYBRID_INDEXING_INTEGRATION.md (5 KB architecture)
- Updated README with API docs link + consolidation warning
- Documented all hybrid indexing endpoints with examples
## IMPROVEMENTS:
- Selective semantic indexing now actually ingests files (was placeholder)
- Health check now correctly queries SQLite instead of PostgreSQL
- All authentication endpoints now functional
- Structural indexing stores as pure JSON (no embeddings)
Impact: Team sharing now works, all features documented, critical bugs fixed.
Tested: Pistn indexing (3,117 files in 3 seconds) ✅🚀 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Implemented optional authentication to keep strangers out of the
Claude OS frontend when deployed to production servers.
Backend (FastAPI):
- mcp_server/auth.py: JWT-based authentication
* Bcrypt password hashing
* Environment-based user credentials (no database needed)
* 7-day token expiration
* Optional - disabled by default
- mcp_server/server.py: Auth endpoints
* POST /api/auth/login - Returns JWT token
* GET /api/auth/me - Get current user
* GET /api/auth/status - Check if auth enabled
- requirements.txt: Added dependencies
* passlib[bcrypt] for password hashing
* python-jose[cryptography] for JWT
* python-multipart for form data
Frontend (React):
- frontend/src/lib/auth.tsx: Auth context and hooks
* Manages authentication state
* Automatic token validation
* localStorage for token persistence
- frontend/src/pages/Login.tsx: Beautiful login page
* Gradient design matching Claude OS branding
* Clear error messages
* Loading states
- frontend/src/components/ProtectedRoute.tsx: Route protection
* Automatically redirects to login if not authenticated
* Shows loading state during auth check
* Bypasses auth if disabled
- frontend/src/App.tsx: Integrated auth
* Wrapped app in AuthProvider
* Protected routes for Welcome and MainApp
* Login route for authentication
Documentation:
- AUTH_SETUP.md: Complete authentication guide
* Quick start instructions
* Password hash generation
* Production deployment steps
* Troubleshooting guide
- .env.example: Added auth configuration
* CLAUDE_OS_EMAIL (login email)
* CLAUDE_OS_PASSWORD (dev - plain text)
* CLAUDE_OS_PASSWORD_HASH (production - bcrypt hash)
* CLAUDE_OS_SECRET_KEY (JWT secret)
- docs/PRODUCTION_DEPLOYMENT.md: Added Step 5
* Authentication setup for production
* Hash and secret generation commands
* Testing instructions
Features:
✅ Optional authentication (disabled by default)
✅ Single user via environment variables
✅ Secure bcrypt hashing
✅ JWT tokens with 7-day expiration
✅ Beautiful login UI
✅ No database required for user management
Usage:
1. Set CLAUDE_OS_EMAIL and CLAUDE_OS_PASSWORD in .env
2. Restart Claude OS
3. Visit /login to authenticate
4. Token valid for 7 days
To disable auth: Remove CLAUDE_OS_EMAIL from .env
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Integrate Agent-OS by Builder Methods (CasJam Media LLC) as an optional
component during Claude OS installation, following a partner approach that
respects their project while creating a complete AI development system.
Key Changes:
- Updated install.sh to optionally clone Agent-OS from their GitHub repo
- Added proper attribution to Builder Methods throughout documentation
- Created "Acknowledgments" section in README with full credit
- Marked Agent-OS as optional in all user-facing docs
- Added graceful fallback if Agent-OS installation fails
Integration Approach:
- Partner model: git clone from https://github.com/builder-methods/agent-os
- Optional installation: users choose during ./install.sh
- MIT license compliance: all required copyright notices included
- Upstream updates: git clone ensures users get their latest improvements
- Clean separation: Agent-OS remains a separate, credited project
Files Modified:
- install.sh: Added Agent-OS installation prompt (lines 156-211)
- README.md: Added attribution in Agent-OS section and Acknowledgments
- SHARING_GUIDE.md: Updated to reflect optional Agent-OS integration
Benefits:
- Respects Builder Methods' work with proper attribution
- Creates complete system: Claude OS (memory) + Agent-OS (workflows)
- Users get upstream updates automatically
- Optional for flexibility
- MIT license compliant
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
The /initialize-project command outputs the MCP URLs directly,
so no need to tell users to manually find them in the UI.
Just note that the command shows the URLs to use.
Much cleaner and simpler.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Changed:
- Updated MCP Integration section title to reference Claude CLI
- Updated feature list to mention Claude CLI integration
- Updated 'Perfect For' section to mention Claude CLI
- Updated 'Initialize Your Project' section
- Updated 'Via Claude CLI' in knowledge base query section
- Updated Architecture diagram to show Claude CLI instead of Desktop
The MCPs are designed for use with Claude CLI, not Claude Desktop.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Changed:
- Removed detailed MCP integration instructions
- Removed old example MCP names (pistn, pistn-agent-os)
- Simplified to note that /initialize-project creates 4 MCPs automatically
- Explained the 4 auto-generated MCPs and their purposes
- Directed users to Project Setup modal for MCP URLs
The initialize-project skill handles all MCP creation, so manual
configuration instructions were unnecessary and outdated.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Changed:
- Replaced misleading one-liner curl command with explicit clone + setup flow
- Updated 'Quick Install' section to show 3 clear steps
- Updated 'Installation (Step by Step)' to include clone step
- Changed step numbering from 4 to 5 steps total
- Made it clear that setup.sh must be run from within the repo
The setup.sh script requires relative paths to work, so users must
clone the repository first before running setup.
This matches standard Git project workflows and is now honest about
what's required to get the full installation.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Updated Step 3 to be crystal clear:
- Users must OPEN Claude Code and copy-paste the command
- Added prominent instruction: 'Open Claude Code and copy-paste'
- Added warning to replace project ID with actual number
- Added 3 clear examples with different project IDs
- Detailed what happens after running the command
- Explained the benefits: Claude becomes an expert, auto-updates on commits
This makes the workflow much clearer for users.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Added:
- One-line installer instructions with prerequisites clearly listed
- Step-by-step installation guide for macOS and Linux
- Detailed Scripts Guide documenting all 8 shell scripts
- Project initialization workflow (3 steps to make Claude an expert)
- Clear explanation of setup.sh vs setup_native.sh differences
- Honest documentation of what auto-installs vs what needs pre-installation
Changes:
- Reorganized Quick Start section with prerequisites at top
- Added one-line curl installer option prominently
- Expanded Scripts Guide with individual sections for each script
- Added "Initialize Your Project" section with project creation and ID steps
- Clarified that Python 3.11+ and Git must be pre-installed
- Documented that Ollama and Redis auto-install if missing
This makes Claude OS onboarding much clearer and more professional.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Features:
- Fixed Ollama configuration for native (localhost) instead of Docker
- Increased LLM timeout from 30s to 120s for quality answers
- Implemented KB slug system for clean MCP endpoint URLs
- Added multiple knowledge base support with type metadata
- Integrated MCP server with FastAPI (port 8051)
- React frontend with KB management UI
- PostgreSQL + pgvector for vector embeddings
Performance:
- 33-56% faster than Docker setup with native Ollama
- Direct Metal GPU acceleration on Apple Silicon
- Optimized RAG engine with caching
- ~40s response time for comprehensive answers
Documentation:
- Complete native setup guide (README_NATIVE_SETUP.md)
- Performance benchmarking and comparison
- MCP endpoint documentation
- Slug implementation details
- Decision rationale for native vs Docker
Cleanup:
- Removed old Streamlit setup files
- Consolidated setup scripts to single setup_native.sh
- Consolidated service management scripts
- Removed test artifacts and old analysis docs
- Ready for sharing with team
🚀 Production-ready for local team deployment
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
