Strix is a stateful AI assistant built with the Claude Agent SDK and Telegram. It maintains persistent memory through file-based state management and can autonomously use tools to communicate and manage its own memory.

• Claude Agent SDK: Autonomous agent with built-in file operations
• Telegram (via grammY): User interface
• File-based Memory: Three-tier memory system (identity, working memory, temporal awareness)
• Custom Tools: Telegram communication tools (send_message, send_reaction, send_image)

Dependencies are already installed. You have:

• Claude Code CLI (globally installed)
• @anthropic-ai/claude-agent-sdk
• grammy (Telegram bot framework)
• zod (schema validation)
• dotenv (environment variables)

Edit .env file and add your API keys:

# Get from https://console.anthropic.com
ANTHROPIC_API_KEY=sk-ant-api03-your-key-here

# Get from @BotFather on Telegram
TELEGRAM_BOT_TOKEN=123456789:your-token-here

To create a Telegram bot:

1. Open Telegram and search for @BotFather
2. Send /newbot command
3. Follow prompts to choose a name and username
4. Copy the token to your .env file

bun run index.ts

You should see:

🦉 Starting Strix...
📡 Connecting to Telegram...
✅ Strix is now running!
💬 Send a message to your bot on Telegram to begin

1. Find your bot on Telegram (search for the username you chose)
2. Send /start to get a welcome message
3. Send any message - Strix will respond using the Claude Agent SDK
4. Check state/ files to see memory updates
5. Check logs/journal.jsonl for interaction logs

User sends Telegram message
    ↓
grammY receives message
    ↓
Handler loads memory context from state files
    ↓
Claude Agent SDK processes with memory + custom tools
    ↓
Agent autonomously uses tools:
    - send_message to respond to user
    - Read/Write/Edit to manage state files
    - Bash to commit changes to Git
    ↓
Interaction logged to journal

Persistent Identity (.claude/CLAUDE.md):

• Loaded automatically by Agent SDK
• Defines Strix's persona and operational guidelines

Working Memory (state/*.md):

• inbox.md - Unprocessed items
• today.md - Current tasks
• commitments.md - Promises made
• patterns.md - Learned behaviors

Temporal Awareness (logs/*.jsonl):

• journal.jsonl - Conversation history
• events.jsonl - System events

Strix can use these Telegram-specific tools:

• send_message: Send text to user (can call multiple times)
• send_reaction: React with emoji
• send_image: Send images with captions

Plus all Claude Agent SDK built-in tools:

• Read, Write, Edit: File operations
• Bash: Run commands (for Git commits)
• Grep, Glob: Search capabilities

strix/
├── .claude/
│   └── CLAUDE.md              # Strix's persona (loaded by Agent SDK)
├── src/
│   ├── agent/tools/
│   │   └── telegram-tools.ts  # Custom Telegram tools
│   ├── bot/
│   │   ├── telegram.ts        # Bot initialization
│   │   └── handlers.ts        # Message handlers (main integration)
│   └── memory/
│       ├── loader.ts          # Memory context builder
│       └── journal.ts         # Journal utilities
├── state/                      # Working memory (Git tracked)
│   ├── inbox.md
│   ├── today.md
│   ├── commitments.md
│   ├── patterns.md
├── logs/                       # Temporal awareness
│   ├── journal.jsonl
│   └── events.jsonl
├── index.ts                    # Main entry point
└── .env                        # API keys (not in Git)

Before running, you need to:

1. Add your API keys to .env:

   • Get Anthropic API key from https://console.anthropic.com
   • Get Telegram bot token from @BotFather

2. Run the bot: bun run index.ts

3. Test on Telegram: Send messages to your bot

• Claude Agent SDK Docs
• grammY Documentation
• Original Strix Article

This project was created using bun init in bun v1.2.19. Bun is a fast all-in-one JavaScript runtime.