Prerequisites
- Claude Code CLI installed and authenticated
- An SCM provider token (for creating PRs)
- An issue tracker token
Install ~1 min
brew tap abnegate/tap
brew install claudearOther install methods
APT (Debian/Ubuntu)
curl -fsSL https://abnegate.github.io/apt-repo/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/claudear.gpg
echo "deb [signed-by=/usr/share/keyrings/claudear.gpg] https://abnegate.github.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/claudear.list
sudo apt update && sudo apt install claudearPrebuilt binaries
Download from the releases page for Linux and macOS (Intel/ARM).
From source
git clone https://github.com/abnegate/claudear.git
cd claudear
cargo build --releaseDocker
docker pull ghcr.io/abnegate/claudear:latestConfigure ~2 min
Create a claudear.toml file. This is all you need:
This is all you need
workspace = "~/.claudear/repos"
known_orgs = ["your-org"]
[agent.providers.claude]
model = "sonnet"
[scm.github]
token = "ghp_..."
[issues.linear]
api_key = "lin_api_..."
trigger_labels = ["claude"]
[notifiers.discord]
webhook_url = "https://discord.com/api/webhooks/..."
Tip: That's it. Everything else has sensible defaults. See Recipes for complete stack-specific configs.
Seed (optional)~30s
Mark existing issues as seen so Claudear starts fresh:
claudear seedRun ~1 min
claudear start --poll --port 3100
open http://localhost:3100Claudear is now watching for new issues. When one appears, it will: pick up the issue, write a fix using AI, open a pull request, and notify you.
#Verify it works
Preview which issues Claudear would pick up without running anything:
claudear dry-runThen create a labelled issue in your tracker and confirm the full cycle: issue picked up, PR opened, notification sent, dashboard shows the attempt.