Resonant: A Relational AI Companion Framework Based on Claude Code

Resonant is a relational AI companion framework built on the Claude Code Agent SDK, designed to go beyond stateless AI chat applications. It features persistent sessions, autonomous reach, multi-channel interaction, and a life management system, aiming to create an AI partner that truly understands you and proactively cares for you. The framework is open-source, developed with TypeScript and SvelteKit, and uses local SQLite for data storage.

Most AI chat apps are just stateless wrappers of APIs. Resonant stands out as a persistent, autonomous AI companion that remembers conversations, proactively contacts you, and grows continuously within a trusted security model. Its core concept is 'relational AI'—not a one-time Q&A tool, but an intelligent partner capable of building long-term companionship. Resonant is built using the Claude Code Agent SDK, developed with TypeScript and SvelteKit, and uses local SQLite for data storage.

Resonant has several key features to make AI truly 'alive':

1. Persistent Session Management: Maintains real conversation threads (daily rotation, named threads, cross-restart continuity, thread management like pinning/archiving).
2. Autonomous Reach: AI companion can create routines (morning/noon/evening checkpoints), online triggers, adaptive thresholds, and periodic perception checks—these are self-directed behaviors, not just scheduled tasks.
3. Deep Context Understanding: Injects real-time context (time, dialogue flow, emotion tags, online status) via hooks; Claude Code's native memory handles long-term recall.
4. Multi-channel Presence: Supports Web UI (SvelteKit-based PWA), Discord, Telegram, voice (ElevenLabs TTS + Groq transcription), and Web push notifications.

Resonant wraps the Claude Code Agent SDK in a complete companion infrastructure. The architecture includes Web UI (Svelte), Express + WebSocket Orchestrator (handling hooks, sessions), and Claude Code Agent SDK (with CLAUDE.md for personality, MCP servers, tools). All configurations are stored in resonant.yaml (created by the installation wizard), including identity (companion/user name, timezone), agent models (for interaction and autonomous scheduling), orchestrator (autonomous scheduling enablement), and command center settings (life management system, currency symbol).

Resonant provides rich autonomous behavior primitives:

• Routines: Scheduled autonomous sessions (built-in checkpoints or custom via CLI like sc routine create).
• Pulse: Lightweight periodic perception checks (adjustable frequency).
• Impulses: One-time conditional triggers (e.g., greet on online transition).
• Watchers: Repeating conditional triggers with cooldown (e.g., remind to eat if meal routine missing).
• Timers: Time-specific triggers (e.g., medication reminder).
• Failsafe: Layered inactivity escalation (gentle→concerned→urgent).
• Condition System: Supports presence state/transition, time window, routine missing, etc., with AND combinations.

Resonant's Command Center is a built-in life management system with modules like Dashboard (comprehensive view of tasks/events), Planner (task management with priorities), Care Tracker (health tracking), Calendar (repeat events), Cycle Tracker (period tracking), Pet Care (pet management), Lists (shopping/general), Finances (expense tracking), Stats (trend analysis). The Web UI offers real-time chat with streaming responses, thread management, search (keyword/semantic), file sharing, Canvas editor, message reactions, voice interaction (recording/transcription/TTS), and theme customization (via CSS variables).

Resonant represents the evolutionary direction of AI companions—from passive Q&A tools to proactive, memory-equipped, multi-channel relational agents. It is not just another ChatGPT wrapper but an AI infrastructure that truly understands 'relationships'. Application scenarios include:

1. Personal Companion: An AI partner that proactively cares and lives on your device.
2. Life Management Assistant: Unified entry for tasks, calendar, health, finance via natural language.
3. Research Assistant: Uses arxiv-research skill and semantic search for personal knowledge management.
4. Multi-channel Notification Center: Receives reminders via Discord, Telegram, Web push. For users wanting deeper AI connections and daily integration, Resonant offers an open-source, customizable, local-first solution.