diff --git a/WHAT_IS_CLAUDE_OS.md b/WHAT_IS_CLAUDE_OS.md index f43db18..0840032 100644 --- a/WHAT_IS_CLAUDE_OS.md +++ b/WHAT_IS_CLAUDE_OS.md @@ -216,7 +216,35 @@ Claude instantly knows: --- -### 5. πŸ”Œ **MCP Integration** (The Claude Code Bridge) +### 5. 🎯 **Session Management** (Never Lose Context Again) + +Every time you start a new conversation, Claude OS automatically checks your session state and loads relevant context. + +``` +New Conversation Starts + ↓ +Claude OS checks: "What were we working on?" + ↓ +Loads: Active session, recent memories, current branch, decisions made + ↓ +Prompts: "Continue working on [feature]?" or "Start something new?" +``` + +**What this means for you:** + +- **Zero cold starts** - Every conversation picks up where you left off +- **Automatic context loading** - Relevant memories surfaced immediately +- **Session tracking** - Track task, branch, decisions, blockers across days +- **Resume anywhere** - Start on laptop, continue on desktop, same context +- **Work tracking** - Know exactly what was accomplished, what's next + +**The Result:** + +No more "what was I doing?" moments. Claude knows what you're working on before you even ask. + +--- + +### 6. πŸ”Œ **MCP Integration** (The Claude Code Bridge) MCPs (Model Context Protocol) are the bridge between Claude OS and Claude Code. They expose all Claude OS knowledge directly to you. @@ -248,6 +276,108 @@ Every MCP has: --- +## 🀝 **Team Collaboration & Sharing** (Built for Teams) + +Claude OS isn't just for solo developersβ€”it's designed for teams to share knowledge. + +``` +Your Claude OS Setup + ↓ +One Command: ./install.sh + ↓ +Teammates Get: All commands, skills, templates instantly + ↓ +Each Project: /claude-os-init (2 minutes) + ↓ +Team Shares: CLAUDE.md (in git), separate memories (private) +``` + +**How team sharing works:** + +- **Template system** - Commands and skills shared via symlinks, updates propagate instantly +- **One-command install** - Teammates run `./install.sh`, done in 3 minutes +- **Project isolation** - Each project has separate knowledge bases +- **Shared context** - CLAUDE.md in git gives everyone the same project overview +- **Private memories** - Each developer's memories stay private (git-ignored) +- **Update once, benefit everywhere** - Update templates, all projects get improvements + +**The Result:** + +Onboard new developers in minutes, not weeks. They get institutional knowledge from day one. + +--- + +## 🎨 **Agent-OS Integration** (Spec-Driven Development - Optional) + +Partner with Agent-OS by Builder Methods for structured feature development. + +**8 Specialized Agents:** + +1. **spec-initializer** - Create feature specification directories +2. **spec-shaper** - Gather requirements through iterative questions +3. **spec-writer** - Generate detailed technical specifications +4. **tasks-list-creator** - Break specs into actionable tasks +5. **implementer** - Implement features following task list +6. **implementation-verifier** - Verify implementation completeness +7. **spec-verifier** - Ensure spec and tasks consistency +8. **product-planner** - Create product documentation + +**The workflow:** + +``` +/new-spec user-authentication + ↓ +/create-spec (answers 1-3 questions at a time) + ↓ +Spec.md + Tasks.md generated + ↓ +/implement-spec user-authentication + ↓ +Feature implemented, tested, verified +``` + +**Why this matters:** + +- **Structured planning** - Think before coding +- **Clear requirements** - No more "wait, what did we want?" +- **Task breakdown** - Implementation steps crystal clear +- **Verification built-in** - Ensures nothing missed +- **Documentation automatic** - Spec becomes permanent record + +**Integration with Claude OS:** + +Agent-OS agents search Claude OS memories before creating specs, ensuring they build on existing patterns and decisions. Perfect synergy. + +--- + +## ⚑ **Smart Commands & Triggers** (Your AI Assistant on Autopilot) + +Claude OS gives you powerful slash commands and automatic triggers. + +**Essential Commands:** + +- `/claude-os-search "query"` - Search all memories and docs +- `/claude-os-remember "content"` - Quick save to memories +- `/claude-os-save "title"` - Full-featured save with KB selection +- `/claude-os-list` - View all knowledge bases +- `/claude-os-session start` - Begin tracking a feature +- `/claude-os-triggers` - Manage automatic triggers + +**Automatic Triggers:** + +When you say phrases like these, Claude automatically saves to memories: +- "Remember this:" +- "Save this:" +- "Document this:" +- "Note this:" +- "Keep in mind:" + +**The Result:** + +Building institutional knowledge happens naturally as you work. No manual note-taking needed. + +--- + ## What Can Claude OS Actually Do For You? πŸš€ ### ⚑ **Immediate Productivity Wins** @@ -350,6 +480,10 @@ accounts tableβ€”there's a large blob field that causes performance issues." | Learns from your decisions | ❌ | ❌ | ❌ | βœ… Automatically | | Writes in your style | ❌ | ❌ | Partial | βœ… Always | | Persists context between sessions | ❌ | ❌ | ❌ | βœ… Forever | +| Session management & tracking | ❌ | ❌ | ❌ | βœ… Built-in | +| Automatic context loading | ❌ | ❌ | ❌ | βœ… Every session | +| Spec-driven development | ❌ | ❌ | ❌ | βœ… Optional | +| Team sharing & collaboration | ❌ | ❌ | ❌ | βœ… One install | | Detects your bugs before they happen | ❌ | ❌ | ❌ | βœ… Via patterns | | Works offline | N/A | βœ… | βœ… | βœ… Yes | | Requires zero setup per project | ❌ | βœ… | βœ… | βœ… One command | @@ -464,18 +598,26 @@ This is the **compounding intelligence** that happens when AI actually understan ## Getting Started in 3 Steps ```bash -# 1. Install Claude OS (already running locally) +# 1. Install Claude OS (one-time, 3 minutes) +git clone https://github.com/your-org/claude-os.git +cd claude-os +./install.sh + +# 2. Start Claude OS +./start.sh + +# 3. Initialize your project (2 minutes) cd /path/to/your/project - -# 2. Initialize your project (5 minute setup) -/initialize-project [project-id] - -# 3. Start developing (Claude now knows everything) -# That's it! You're done. +/claude-os-init +# Answer a few questions, done! ``` Now every conversation with Claude includes your complete project knowledge. +**For Teams:** + +Share the repo URL with teammates. They run `./install.sh` and get everything you have. Each project they work on runs `/claude-os-init` once. That's it. + --- ## The Real Magic ✨ diff --git a/docs/QUICK_REFERENCE.md b/docs/QUICK_REFERENCE.md index 8db73bf..a7f810f 100644 --- a/docs/QUICK_REFERENCE.md +++ b/docs/QUICK_REFERENCE.md @@ -313,6 +313,7 @@ ollama list ### Trigger Phrases (Auto-Save) When you say these, Claude automatically saves to memories: + - "Remember this:" - "Save this:" - "Document this:" @@ -345,11 +346,13 @@ When you say these, Claude automatically saves to memories: ## πŸ“Š Performance Expectations ### Local Development (Mac) + - Query response: 2-10 seconds - Memory search: 1-3 seconds - Document upload: < 1 second ### Production Server (16 CPU / 32GB RAM) + - Simple queries: 1-5 seconds - Complex queries: 5-15 seconds - Concurrent users: 50+ without slowdown @@ -359,11 +362,13 @@ When you say these, Claude automatically saves to memories: ## πŸ” Security Notes ### Local Development + - Runs on localhost:8051 - Only accessible from your machine - Data stays local ### Production Server + - MCP server localhost only (127.0.0.1) - External access via app (authenticated) - Daily backups, 7-day retention @@ -375,16 +380,19 @@ When you say these, Claude automatically saves to memories: ## πŸ“ž Support & Resources ### Logs Locations + - **Local**: `~/Projects/claude-os/logs/` - **Production**: `/opt/claude-os/logs/` - **Systemd**: `sudo journalctl -u claude-os` ### Config Locations + - **Local**: `~/Projects/claude-os/claude-os-config.json` - **Production**: `/opt/claude-os/claude-os-config.json` - **Project**: `.claude-os/config.json` ### Documentation + - **Full README**: `README.md` - **Deployment Guide**: `docs/DEPLOYMENT_GUIDE.md` - **Sharing Guide**: `SHARING_GUIDE.md`