apple-notes

Claude-Agent

Turn Claude Code into a persistent personal assistant with autonomous memory, multi-channel support, and intelligent task delegation.

Claude-Agent is a ready-to-use Claude Code project that transforms Claude into a long-running personal assistant. It receives messages from multiple channels (Telegram, Discord, webhooks, terminal), remembers context across sessions, and delegates complex tasks to specialist agents — all within Claude Code's native architecture.

Features

Architecture

Modular server architecture inspired by Claude Code's internal service layer pattern.

claude-agent/
├── .claude/
│   ├── settings.json            Hook configuration + env vars
│   ├── hooks/ (4)               Session lifecycle (Node.js)
│   ├── agents/ (4)              researcher, writer, analyst, content-publisher
│   ├── skills/ (49)             7 categories — see Skills Reference below
│   └── rules/ (4)               memory, channels, MCP, content quality
├── app/
│   ├── server/
│   │   ├── index.ts             App assembly + server startup (pure wiring)
│   │   ├── routes/ (14)         Modular REST API routes by domain
│   │   │   ├── sessions.ts      Session CRUD
│   │   │   ├── settings.ts      Language/model/CLI settings
│   │   │   ├── project.ts       Project directory management
│   │   │   ├── skills.ts        Skill management (49 skills)
│   │   │   ├── agents.ts        Agent management
│   │   │   ├── mcp.ts           MCP server configuration
│   │   │   ├── channels.ts      Telegram/Discord channel control
│   │   │   ├── roles.ts         Per-chat role system (14 APIs)
│   │   │   ├── scheduled-tasks.ts  Cron task scheduling
│   │   │   ├── secrets.ts       API key management
│   │   │   ├── discussions.ts   Multi-expert discussion
│   │   │   ├── memory.ts        Memory file read/write
│   │   │   ├── history.ts       Cross-session search
│   │   │   ├── cli.ts           CLI detection + migration
│   │   │   └── system.ts        Health, export, stats, webhook
│   │   ├── ws/handler.ts        WebSocket session management
│   │   ├── agent.ts             AgentSession (Claude CLI wrapper)
│   │   │   ├── sendMessage()     Injects system context + session summary
│   │   │   ├── spawnClaude()     Dynamic 5-layer system prompt
│   │   │   ├── rotate()          Async rotation with compact summary
│   │   │   └── generateCompactSummary()  9-section summary via haiku
│   │   ├── stream-handler.ts    Shared streaming (flush/typing/memory strip)
│   │   ├── memory-extractor.ts  Non-blocking background memory extraction
│   │   ├── telegram.ts          Telegram bridge (polling + media + commands)
│   │   ├── discord.ts           Discord bridge (client + attachments)
│   │   ├── reply-filter.ts      Group reply decision (5 modes)
│   │   ├── discussion.ts        Multi-expert discussion engine
│   │   ├── scheduler.ts         Cron task scheduler
│   │   ├── db.ts                SQLite data layer
│   │   ├── middleware/
│   │   │   ├── security.ts      Path validation + name sanitization
│   │   │   └── rate-limiter.ts  API rate limiting
│   │   ├── prompts/
│   │   │   ├── config-bot.ts    Config Bot system prompt
│   │   │   └── compact.ts       9-section compact summary prompt
│   │   └── constants/
│   │       └── languages.ts     Multi-language rules (en/zh-TW/ja)
│   ├── client/
│   │   ├── App.tsx              React 18 + Tailwind (12 pages)
│   │   ├── i18n.ts              Translations (en, zh-TW, ja)
│   │   └── components/ (12)     Chat, History, Projects, Skills, Agents, Memory, MCP, Secrets, Tasks, Config Bot, Settings, Channels
│   ├── electron/main.cjs        Desktop app entry point
│   └── package.json             App dependencies
├── memory/                      Persistent memory (auto-managed)
├── scripts/migrate-openclaw.cjs One-click OpenClaw migration
├── workspace/                   Runtime output (gitignored)
├── .mcp.json                    4 MCP servers (trend-pulse, claude-101, cf-browser, notebooklm)
├── CLAUDE.md                    Assistant identity + operating rules
└── README.md

Installation

git clone https://github.com/claude-world/claude-agent.git
cd claude-agent

Prerequisites

• Node.js >= 18
• Claude Code CLI — for Method 1 & 3. Install here

Three Ways to Use

---

Method 1: CLI (Terminal)

# Start Claude Code in the project directory
claude

# First time? Run guided setup
/setup

/setup will:

• Detect your OS and installed CLI tools
• Configure your profile (name, timezone, language)
• Show available skills grouped by category
• Set up scheduled routines (memory consolidation, daily briefing)

After setup, just talk naturally:

• "What's the weather in Taipei?"
• "Play some music"
• "Remind me to call the dentist at 3pm"
• "What's trending?"

---

Method 2: Web UI (Browser)

cd app
npm install    # First time only
npm run dev    # Start the control panel

Open http://localhost:3456 in your browser.

12 Pages:

---

Method 3: Telegram / Discord

*Option A: Via Claude Code Channels (native)