Skip to content

Use case

Run scheduled coding workflows with Claude Code and Codex

Pairbar is a macOS app that runs Claude Code and Codex prompts on a schedule, as workflows you describe in plain words. You say what you want and when; your own Claude or Codex plans the steps (which run side by side, on which app, with which permissions, and a goal to check), you review the plan, and Pairbar runs it through the official claude and codex command-line tools while it's running on your Mac.

Last updated

WAVE 1WAVE 2GOAL CHECKFind failing testsCan run commandscodex · workspace-writeRead recent issuesRead-onlyclaude · no edit toolsFix the failuresCan edit filesAsk me firstCheck the goalread-onlyGOAL METSteps that wait for the same thing run side by side; each has its own app, model and permissions.
A workflow's steps grouped in waves: steps in the same wave run side by side, each with its permission level, and a goal check at the end.

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

  1. Describe the job
    In 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.
  2. Let your own Claude or Codex plan it
    The 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.
  3. Review the plan
    The 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.
  4. Set the guard rails
    Check 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).
  5. Let it run
    Each 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

Ready-made ideas shown in the empty Workflows tab, written for the repo you work in most
IdeaSchedulePermissions
Review waiting PRs (only when you have a reviewer agent)weekdays 9:00Can run commands (gh)
Fix CI failuresdaily 8:00Can edit files
Triage new issuesweekdays 9:00Can run commands (gh)
Keep docs fresh (only with a docs folder)Wednesdays 9:00Can edit files
Weekly release notesFridays 16:00Can 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:

ApproachGood forWhat you build yourself
cron or launchd running claude -p / codex execone simple prompt on your Macpermissions, 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 offsecrets, 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 sandboxa 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.

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.