ChronoMind

A personal AI assistant with persistent memory, powered by Claude AI.

中文文档

Features

• Interactive Chat - Natural conversation with Claude AI
• Persistent Memory - Remember context across sessions
• Task Management - Schedule and track tasks
• Goal Tracking - Set and monitor personal goals
• Daily Notes - Automatic daily summaries and reflections
• Telegram Bot - Interact via Telegram messages
• Background Daemon - Run as a background service

Requirements

• Node.js 22+ (Node.js 23+ recommended)
• Anthropic API access

Quick Start

# Clone the repository
git clone <repository-url>
cd ChronoMind

# Install dependencies
npm install

# Copy configuration
cp config.example.yaml config.yaml

# Set required environment variables
export ANTHROPIC_BASE_URL=https://api.anthropic.com
export ANTHROPIC_AUTH_TOKEN=your-auth-token-here

# Start interactive chat
npm run cli

Configuration

Environment Variables

Variable	Description	Required
ANTHROPIC_BASE_URL	Claude API endpoint	Yes
ANTHROPIC_AUTH_TOKEN	Your API auth token	Yes
TELEGRAM_BOT_TOKEN	Telegram bot token	No
TELEGRAM_CHAT_ID	Default Telegram chat	No
LOG_LEVEL	Logging level	No

Config File

Copy config.example.yaml to config.yaml and customize:

cp config.example.yaml config.yaml

Usage

Interactive Mode (Default)

npm run cli
# or
tsx bin/chronomind.ts

Single Command Execution

tsx bin/chronomind.ts exec "What can you help me with?"

Background Daemon

# Start daemon with Telegram and scheduler
tsx bin/chronomind.ts start --telegram --scheduler

# Check status
tsx bin/chronomind.ts status

# Stop daemon
tsx bin/chronomind.ts stop

CLI Commands

Command	Description
chat	Start interactive chat (default)
exec <prompt>	Execute a single prompt
start	Start background daemon
stop	Stop background daemon
status	Show daemon status
task	Manage scheduled tasks
memory	Manage memory system
goal	Set and track goals
daily	Daily notes and summaries
history	View conversation history
analyze	Analyze data or patterns
modify	Modify configurations
config	Manage settings

Run tsx bin/chronomind.ts --help for more details.

Development

# Run tests
npm test

# Type check
npm run typecheck

# Build
npm run build

# Development mode
npm run dev

Project Structure

chronomind/
├── src/
│   ├── cli/            # CLI commands and interface
│   ├── agent/          # Claude Agent SDK integration
│   ├── memory/         # Persistent memory system
│   ├── scheduler/      # Task scheduling
│   ├── telegram/       # Telegram bot integration
│   ├── db/             # SQLite database layer
│   ├── config/         # Configuration management
│   ├── logger/         # Logging system
│   └── types/          # TypeScript types
├── workspace/
│   ├── memory/         # Memory storage files
│   └── data/           # SQLite database
├── bin/                # CLI entry point
└── tests/              # Test files

License

MIT