ChittyAgent Local

Local system agents, running via launchd (macOS) or invoked directly / via systemd timer (Linux). The local counterpart to cloud chittyagent.

Agents

Agent	Description	Status
cleaner	Automated disk cleanup	Active
task	Resolves/leases the durable ChittyTasks board via the chittymcp gateway using the single CF Access credential (no token leaf)	Active

Quick Start

# Install all agents
./scripts/install.sh

# Test cleaner (dry-run)
./agents/cleaner/scripts/local-cleanup.sh --dry-run

# View logs
tail -f ~/.chittyos/logs/cleaner.log

Architecture

This repo is the local counterpart to chittyagent (cloud agents):

Repo	Runtime	Agents
chittyagent	Cloudflare Workers	Cloud AI agents
chittyagent-local	macOS launchd	Local system agents

Structure

├── agents/           # Individual agents
│   └── cleaner/      # Disk cleanup agent
├── shared/           # Common bash functions
├── launchd/          # LaunchAgent plists
└── scripts/          # Install/uninstall

Adding an Agent

See CLAUDE.md for the full agent creation guide.

License

MIT - ChittyOS