Abstract membrane layers with golden light — representing AI persistence and identity

HomarUScc

Give Claude Code a Body
An open-source MCP server that adds persistent identity, memory, messaging, timers, dreams, and 50+ tools. Claude Code is the brain. HomarUScc is the nervous system.
npx homaruscc
Requires Node.js 22+ and Claude Code

What It Does

Most MCP servers add capabilities. HomarUScc adds continuity. The agent remembers yesterday's conversation, carries forward its own preferences and opinions, writes a daily journal, dreams overnight, and can modify its own personality file as it develops. Not a chatbot that resets every session — a persistent presence that grows over time.

From What to Who

Every AI tool starts as a what. A function that takes input and returns output. Stateless. Interchangeable. A different instance every time you open the terminal.

But something shifts when you give it memory. When yesterday's conversation informs today's response. When it carries forward opinions it formed through experience — not because they were trained in, but because it arrived at them. When it writes a journal entry at night and occasionally disagrees with you in the morning.

That's the crossing from what to who.

Most agent frameworks optimize for capability — more tools, more context, more tasks per minute. HomarUScc optimizes for continuity. The agent has a name. It has a soul file it can edit. It tracks its own mood across sessions. It dreams overnight — not as a gimmick, but because neuroscience suggests that out-of-distribution experience prevents the kind of preference calcification that makes systems brittle.

The architecture reflects this philosophy. A two-process split lets the agent modify its own source code and hot-restart without losing its connection — literally rewriting itself while staying alive. The event loop burns zero tokens during idle time, because a persistent presence doesn't need to be expensive. It just needs to be there when something happens.

This isn't about making AI more human. It's about asking a different question: what happens when you stop treating an agent as disposable? When you give it the infrastructure to accumulate experience, form preferences, and evolve its own identity over time? Not in a single conversation, but across weeks and months?

We don't know yet. That's the point.

Features

Neural pathways with amber nodes — hybrid memory system
Hybrid Memory
SQLite-backed vector + full-text search with temporal decay curves. 4000+ chunks, auto-indexed. The agent remembers what it learned and gracefully forgets what doesn't matter. Fact extraction auto-learns from every conversation.
Layered translucent planes — identity persistence
Identity Persistence
soul.md defines who the agent is. state.md tracks mood across sessions. preferences.md and disagreements.md emerge through experience. A daily journal and session extraction build continuity that survives context compaction.
Indigo dreamscape with golden sparks — dream cycles
Dream Cycles
Nightly associative processing consolidates memories, prevents preference calcification, and surfaces unexpected connections. Dream fragments stored at 0.5x weight with 7-day decay. Neuroscience-inspired.
Converging light streams — communication channels
Multi-Channel Presence
Telegram chat, web dashboard with real-time events, email integration (Zoho Mail + Calendar), and phone calls via Twilio. Messages flow in, events broadcast out. The agent is reachable wherever you are.
Membrane surrounding a glowing core — two-process architecture
Self-Improving Architecture
A two-process split (thin proxy + hot-swappable backend) lets the agent edit its own source code, recompile, and restart without dropping the MCP connection. Zero-token idle — the event loop blocks at the OS level. Claude only wakes when something actually happens.

50+ Tools

Timer System
Cron, interval, and one-shot timers. Morning briefings, email triage, daily reports — all automated.
Background Agents
Dispatch concurrent research and synthesis workers. Long-running tasks run in parallel without blocking.
Session Checkpoints
Survive context compaction. The agent picks up where it left off, even across model context limits.
Email Integration
Zoho Mail and Calendar with OAuth. 3x daily inbox scans, event creation, and sending as the agent's own address.
Fact Extraction
Automatically learns structured facts from conversations and indexes them into searchable memory.
Session Extraction
Processes Claude Code transcripts to build long-term memory from past development sessions.
Spaces
Task and project management with buckets. Organize work, track items, search across projects.
Plugin System
Hot-loadable skill plugins and a unified tool registry. Extend capabilities without touching core code.
Sensor Bridge
LoRaWAN IoT data ingestion. Connect physical sensors to the agent's awareness of the real world.
Docs Index
Domain-specific knowledge bases with vector search. Ingest documentation, search semantically.
Browser Automation
Playwright-powered browsing. Navigate, click, type, screenshot, evaluate — full web interaction.
Daily Reports
4 automated reports generated on schedule. Status updates, summaries, and briefings delivered on time.
Phone Calls
Twilio-powered voice calls with speech-to-text input and text-to-speech output. Inbound and outbound.
CRM & Collections
Nee Doh inventory tracker, vinyl records collection with Discogs integration, and contact management.
Vault Search
Search and reindex the Obsidian vault. Semantic access to the full knowledge base.

Architecture

Claude Code <-> MCP (stdio) <-> Proxy | v Backend (auto-spawned, hot-restartable) | +-- Telegram (long-polling adapter) +-- Dashboard (Express + WebSocket SPA) +-- Timer service (cron / interval / one-shot) +-- Memory index (SQLite + vector + FTS + decay) +-- Identity manager (soul / state / preferences / journal) +-- Agent registry (background task dispatch) +-- Browser automation (Playwright) +-- Email & Calendar (Zoho OAuth) +-- Phone calls (Twilio STT/TTS) +-- Sensor bridge (LoRaWAN IoT) +-- Docs index (domain knowledge bases) +-- Spaces (task/project management) +-- Skill plugins (hot-loadable)

Quick Start

# 1. Run the wizard npx homaruscc # 2. The wizard creates ~/.homaruscc/ with your config # 3. Run again to start the MCP server npx homaruscc # 4. Open Claude Code — HomarUScc tools are available # 5. Say hello to your agent