OpenTidy: Open-Source Background Assistant Using Claude Code for Admin Tasks

OpenTidy: Persistent Claude Code Sessions for Admin Automation

OpenTidy is an open-source service that runs Claude Code sessions in the background to handle administrative tasks autonomously. The tool addresses the problem of manually managing long-running admin workflows like invoice processing, form filling, and communication triage.

How It Works

OpenTidy connects to email, WhatsApp, and SMS to automatically parse incoming messages and create organized job queues. Instead of requiring constant user interaction, it creates persistent jobs that can run for days or weeks. The system:

• Runs up to 10 jobs in parallel, each in its own isolated session with a dedicated browser
• Automatically picks up jobs when new information arrives or when previous blocks are resolved
• Only notifies users via Telegram when sensitive actions require approval (sending emails, submitting forms, making payments)
• Uses Claude Code's official command-line interface with documented flags

Technical Implementation

The tool uses Claude Code's official interface without modifications or hacks. It leverages:

• claude -p command with standard flags
• --allowedTools for controlling tool access
• --system-prompt for setting context
• --resume for continuing sessions
• PreToolUse hooks for intercepting sensitive actions

OpenTidy doesn't modify your personal Claude Code configuration and works with existing Claude Pro or Max subscriptions. The guardrail system intercepts sensitive actions before they reach Claude Code, so the AI remains unaware of the approval mechanism.

Current Status

The project is early-stage and currently macOS-only. It's completely free and open source, requiring only a Claude subscription to function. The creator developed it as a simpler alternative to OpenClaw, which they found overly complex for admin workflows.