cc-claw

A personal AI assistant framework powered by Claude Code. Create persistent AI assistant instances ("claws") with their own persona, memory, and scheduled tasks.

Prerequisites

• Node.js (v18+)
• Claude Code CLI (claude)

Install

npm install -g cc-claw

Or clone and link locally:

git clone <repo-url>
cd ClaudeCodeClaw
npm link

Usage

Create a new claw

cc-claw init <name>

Creates a claw project at ~/.cc-claw/claws/<name>/ and registers <name> as a shell command.

Chat with a claw

cc-claw chat <name>

Starts a Claude Code session in the claw's directory.

List all claws

cc-claw list

Manage scheduled tasks

cc-claw task start <claw>    # start the task scheduler
cc-claw task stop <claw>     # stop the task scheduler
cc-claw task status <claw>   # check scheduler status
cc-claw task run <claw>      # run tasks immediately
cc-claw task logs <claw>     # view task logs

Remove a claw

cc-claw remove <name>

Deletes the claw project, stops its scheduler, and removes its shell command.

Manage aliases

cc-claw alias set <alias> <claw>
cc-claw alias remove <alias>
cc-claw alias list

Claw Project Structure

Each claw lives in ~/.cc-claw/claws/<name>/ with the following files:

File	Purpose
CLAUDE.md	Agent instructions
SOUL.md	Persona definition
USER.md	User profile
MEMORY.md	Long-term memory
tasks.yaml	Scheduled task config (cron/interval/once)
prompts/	Task prompt templates
memory/	Daily notes (auto-archived after 90 days)

Task Configuration

Tasks are defined in tasks.yaml. Three scheduling modes are supported:

tasks:
  daily_review:
    type: cron
    schedule: "0 9 * * *"
    prompt: prompts/daily_review.md
    model: claude-sonnet-4-6
    timeout: 300
    output: memory/
    enabled: true

  check_status:
    type: interval
    schedule: "2h"
    prompt: prompts/status_check.md
    enabled: true

  onboarding:
    type: once
    schedule: "2025-12-31T09:00:00"
    prompt: prompts/onboarding.md
    enabled: true

Contributing

See CONTRIBUTING.md for development setup and guidelines.

This project follows the Contributor Covenant Code of Conduct.

License

MIT