The problem
Plenty of coding chores repeat: triage new issues every morning, look at last night's CI failures, draft Friday's release notes. You can script claude -p or codex exec with cron, but then you're writing the plumbing yourself: permissions per step, retries when the API is overloaded, not burning the plan's limit overnight, and noticing when the job quietly stops working.
How Pairbar solves it
- Describe the jobIn the Workflows tab, choose New workflow and write it in your own words, for example "every weekday at 9, find failing tests and fix them, but ask me before changing code". Pick the folder and press ↩. Write it yourself skips the planner if you prefer.
- Let your own Claude or Codex plan itThe Plan with chip picks which one plans (it defaults to the one with more of its limit left). The planner can only look at the folder and usually takes under a minute. You can leave the tab and return to the same request or completed draft while Pairbar stays open. It decides the steps and what each waits for, the app, model, effort and agent per step, each step's permissions, conditions, the schedule and a goal.
- Review the planThe plan opens in the editor with a banner explaining the choices. Change anything by hand, or type a change into the banner ("use Codex for the fix") to replan. Nothing is saved or run until you press Create workflow.
- Set the guard railsCheck each step's level (Read-only, Can run commands, Can edit files), Scheduled under Trigger (every 15m–8h, daily, weekdays or one weekday, at a time) and Skip under N% (20% by default).
- Let it runEach run is a full agent turn in the background and becomes a chat you can open and continue. You get a notification when it finishes, or when a step with Ask me first is waiting, with Run it and Stop.
Waves: steps that run side by side
A workflow has up to five steps. By default each waits for the one before it; steps that wait for the same thing (or At the start) run at the same time, in the same Wave. A step on the same app as the one before continues that chat; a step on the other app, or set to New chat, starts fresh and gets the previous reply as input. Only if it said WORD lets a step run only when the previous reply ends with that word.
Ideas to start from
| Idea | Schedule | Permissions |
|---|---|---|
| Review waiting PRs (only when you have a reviewer agent) | weekdays 9:00 | Can run commands (gh) |
| Fix CI failures | daily 8:00 | Can edit files |
| Triage new issues | weekdays 9:00 | Can run commands (gh) |
Keep docs fresh (only with a docs folder) | Wednesdays 9:00 | Can edit files |
| Weekly release notes | Fridays 16:00 | Can run commands (gh) |
When it runs, and when it doesn't
- Only while Pairbar is running. A run missed while the Mac was asleep happens once when it wakes, not once for every missed time.
- A new or rescheduled workflow waits for its next time rather than running immediately.
- Skip under N% skips a scheduled run when less than that share of the plan's tightest limit is left; limits are checked before every step. Run now skips the limit check; required startup answers must still be supplied.
- Only one run of a workflow at a time: a scheduled run doesn't start while another still has a step running or waiting for you.
- Temporary errors are retried after 30 s and 60 s; a step with no activity for 10 minutes is restarted once; a step running 30 minutes is stopped as "Timed out".
- With the goal check on, a read-only last step ends with GOAL MET or GOAL NOT MET, and can Try once more.
Without Pairbar
The common ways to schedule agent work yourself:
| Approach | Good for | What you build yourself |
|---|---|---|
cron or launchd running claude -p / codex exec | one simple prompt on your Mac | permissions, retries, limit checks, notifications, history |
| CI (for example a scheduled GitHub Actions job running Claude Code or Codex) | jobs that must run even when your Mac is off | secrets, runners, and API or plan setup for the CI environment |
| Cloud agents started by hand (Claude Code on the web, Codex cloud) | one-off tasks in a hosted sandbox | a schedule, if you want one |
Frequently asked questions
- Do scheduled workflows run when Pairbar is closed?
- No. Workflows run only while Pairbar is running. A run missed while the Mac was asleep happens once when it wakes.
- Does the planner need an API key?
- No. It uses your own Claude or Codex through their command-line tools, so it uses your plan. It can only read the folder: Claude gets Read, Glob and Grep, Codex runs in its read-only sandbox.
- Can one workflow use both Claude and Codex?
- Yes. Each step picks its own app, model, effort and agent, so one step can review with Claude and another fix with Codex.
- How do I stop a workflow from editing code without asking?
- Keep steps at Read-only or Can run commands, or turn on Ask me first for a step. The run then pauses before that step until you choose Run it, and stops by itself after 12 hours with no answer.
- Where are workflows stored?
- As readable JSON in
~/.config/pairbar/, private to your account. The last 300 runs and 10 earlier versions (for Undo) are kept.
Related
- GuideSchedule a Claude Code or Codex workflow on your MacDescribe a job, let Claude or Codex plan it, review the plan, pick a schedule and a limit threshold, and create the workflow.
- GuideChoose the right permission level for each workflow stepThe three step permission levels, the exact Claude Code flags and Codex sandboxes they map to, their caveats and when to use each.
- GuideSet up goal checks and self-healing for your workflowsGoal checks, automatic fixes during a run, health flags, the doctor's suggested fixes, and Undo last change for Pairbar workflows.
- GlossaryWorkflow waveA group of workflow steps that wait for the same earlier steps and therefore run side by side rather than one after another.
- Use caseRe-prompt a Claude Code or Codex chat on a timer until CI is greenA check-in re-sends a message into a chat every 5–60 minutes, up to 3–48 times, and stops when the reply ends with your stop word.
- DocsWorkflowsScheduled prompts, check-ins on a chat, run history, limits
- Use caseLet Claude and Codex chats run your workflows, with you in chargeA chat can run one of your workflows, draft a new one or schedule a check-in on itself, only as your settings allow, within budgets you set.
Try Pairbar free for 7 days
One sidebar for the Claude and Codex desktop apps. Everything on for 7 days, no card needed; then $49/year ($39 first year with LAUNCH), $9/month or $129 lifetime (first 200 buyers). macOS 26 or later, Apple silicon.