claudear

Get started

Recipes

Complete configurations for popular stacks. Copy, paste, fill in your tokens.

#How to use these recipes

Copy the TOML below into your claudear.toml, replace the placeholder tokens with real ones, then run:

claudear seed && claudear start --poll --port 3100

#Recipe: Linear + GitHub + Discord

What you need:

workspace = "~/.claudear/repos"
known_orgs = ["your-org"]

[agent.providers.claude]
model = "sonnet"

[scm.github]
token = "ghp_your_github_token"
auto_resolve_on_merge = true

[issues.linear]
api_key = "lin_api_your_linear_key"
trigger_labels = ["claude"]
trigger_states = ["In Progress"]

[notifiers.discord]
webhook_url = "https://discord.com/api/webhooks/your/webhook"

Issues labelled claude in Linear are picked up, fixed via Claude, and PRs opened on GitHub. Discord gets notified on success or failure.

#Recipe: Sentry + GitHub + Slack

What you need:

  • Sentry auth token
  • GitHub PAT
  • Slack bot token + channel ID
workspace = "~/.claudear/repos"
known_orgs = ["your-org"]

[agent.providers.claude]
model = "sonnet"

[scm.github]
token = "ghp_your_github_token"
auto_resolve_on_merge = true

[issues.sentry]
auth_token = "sntrys_your_sentry_token"
org_slug = "your-org"
project_slugs = ["your-project"]
min_event_count = 10

[notifiers.slack]
bot_token = "xoxb-your-slack-token"
channel_id = "C0123456789"

Sentry errors with 10+ events are auto-triaged. Slack gets notified with bi-directional replies for AI questions.

#Recipe: GitHub Issues + GitHub + Discord

What you need:

  • GitHub PAT
  • Discord webhook URL
workspace = "~/.claudear/repos"
known_orgs = ["your-org"]

[agent.providers.claude]
model = "sonnet"

[scm.github]
token = "ghp_your_github_token"
auto_resolve_on_merge = true
repos = ["your-org/your-repo"]
trigger_labels = ["claudear"]

[notifiers.discord]
webhook_url = "https://discord.com/api/webhooks/your/webhook"

Pure GitHub workflow. Issues labelled claudear get fixed automatically. No external issue tracker needed.

#Recipe: Jira + GitLab + Email

What you need:

  • Jira Cloud URL + email + API token
  • GitLab PAT
  • Email SMTP credentials
workspace = "~/.claudear/repos"
known_orgs = ["your-org"]

[agent.providers.claude]
model = "sonnet"

[scm.gitlab]
token = "glpat-your_gitlab_token"
groups = ["your-group"]
trigger_labels = ["claudear"]

[issues.jira]
base_url = "https://your-org.atlassian.net"
email = "you@company.com"
api_token = "your_jira_api_token"
project_keys = ["PROJ"]
trigger_labels = ["claudear"]

[notifiers.email]
smtp_host = "smtp.gmail.com"
smtp_port = 587
smtp_username = "you@company.com"
smtp_password = "app-password"
from_address = "claudear@company.com"
to_addresses = ["team@company.com"]

#Customising recipes

#Add a second notification channel

[notifiers.slack]
bot_token = "xoxb-..."
channel_id = "C0123456789"

#Enable retry with backoff

[retry]
max_retries = 3
base_delay_ms = 60000
max_delay_ms = 3600000

#Add user mapping

[users.jake]
linear_name = "Jake Barnby"
github_username = "abnegate"
discord_id = "123456789"
email = "jake@company.com"

#Switch to webhooks

# In your config, then run:
# claudear webhook --setup --base-url https://your-server.com
Claudear documentation