Quick Start

Prerequisites

• macOS
• tmux installed
• Claude Code CLI (for Claude/Folder jobs)

Installation

Homebrew (recommended)

brew install --cask tonisives/tap/clawtab

This installs the clawtab GUI app, cwtctl CLI, and cwttui terminal UI.

Build from source

pnpm install
cargo tauri build

Both methods produce three binaries:

Setup Wizard

On first launch, the setup wizard walks through:

1. Tools -- Detects installed tools (editors, terminals, tmux, claude, gopass, aerospace)
2. Notifications -- Choose notification target: ClawTab App (push), Telegram (bot), or skip
3. Hello World -- Creates and runs a test job to verify the setup
4. Web Browse -- Creates an AI job that fetches Hacker News
5. Done -- Saves settings.yaml, marks setup complete

The wizard auto-detects tools and shows version + path for each. Missing tools can be installed via Homebrew directly from the UI.

Creating Your First Job

Binary job (run a script)

1. Open the Jobs panel
2. Click "New Job"
3. Set type to Binary
4. Set path to your script (e.g., /path/to/backup.sh)
5. Set a cron expression (e.g., 0 0 * * * for daily at midnight)
6. Save

Claude job (run a prompt)

1. Set type to Claude
2. Set path to a text file containing your prompt
3. The prompt file content is passed to claude via $(cat /path/to/prompt.txt)
4. Runs inside a tmux window named cwt-<project>

Folder job (project-based AI agent)

1. In ClawTab, click "New Job" and set type to Folder
2. Browse to your project root
3. Enter a Job Name (e.g., "deploy", "lint")
4. Edit job.md with your agent instructions (stored at ~/.config/clawtab/jobs/<slug>/<job-name>/job.md)
5. Optionally add shared context in ~/.config/clawtab/jobs/<slug>/context.md (applies to all jobs in the project)
6. The job runs Claude from the project root with context inlined from central config

All job files (config, prompts, context) are stored centrally at ~/.config/clawtab/jobs/.

Running a Job

• GUI: Click "Run Now" on any job
• CLI: cwtctl run <name>
• TUI: Select job, press r
• Telegram: Send /run <name> to your bot
• Cron: Automatically triggered based on the job's cron expression

Checking Status

cwtctl status

Status values: idle, running, success, failed, paused.