Repolode
Submit
tolimarchuk

tolimarchuk/goalbuddy

A local goal-run workspace that gives Codex and Claude Code a charter, task board, receipts, and a verification loop for long coding tasks.

View on GitHubWebsite
Stars
824
Forks
66
Open issues
10
Last commit
last month

What is it?

GoalBuddy helps Codex and Claude Code stay on track during long coding tasks. It creates a small workspace inside your repo with a goal charter, a state file that tracks the board, notes, and receipts for each completed task, so a run can pause, resume, and verify progress without re-planning every turn.

A goal moves through a fixed loop: a scout maps the repo, a judge picks the largest safe useful slice of work, a worker completes it and leaves a receipt, and a final judge audit checks receipts against the agreed verification signal. A local live board shows the plan, active task, subgoals, and verification status while work runs.

Boards are plain files, so a goal started in one harness can be resumed in the other using `npx goalbuddy resume`. The CLI also includes `dispatch` for running a task on a different vendor's CLI headless, with git-based write-scope checks, and `doctor`, `update`, and `reset` commands for managing the install.

Key features

  • 01Creates a goal charter, state file, and notes folder inside the repo
  • 02Local live board shows plan, active task, receipts, and subgoals
  • 03Works with Codex and Claude Code, and can resume a board in either harness
  • 04dispatch runs a task on another CLI headless and checks write scope with git
  • 05Subgoals let one parent task own a bounded child board

Use cases

  • Running a broad project improvement across many files with verification at each step
  • Preparing a release with checks recorded as receipts
  • Bug hunts that need evidence before a fix is accepted
  • Refactors that must pass tests at defined milestones

Quick start

  1. 1

    Run the one-command setup

    npx goalbuddy
  2. 2

    Restart Codex or Claude Code

  3. 3

    Prepare a goal in Codex with the goal-prep skill

    $goal-prep
  4. 4

    Run the printed Codex /goal or Claude Code /goalbuddy command to execute the board

Things to know

  • Native Codex /goal is an OpenAI-gated feature that GoalBuddy does not enable or replace.
  • Requires Codex or Claude Code to be installed and used as the agent harness.

In collections

Claude Code tools, skills & pluginsAI coding assistants & agents

Topics

#ai#coding-agent#claude-code#codex#workflow#developer-tools#llm

FAQ

What is goalbuddy?
A local goal-run workspace that gives Codex and Claude Code a charter, task board, receipts, and a verification loop for long coding tasks. GoalBuddy helps Codex and Claude Code stay on track during long coding tasks. It creates a small workspace inside your repo with a goal charter, a state file that tracks the board, notes, and receipts for each completed task, so a run can pause, resume, and verify progress without re-planning every turn.
Is goalbuddy free to use? What license does it have?
goalbuddy is open source under the MIT license. Check the license terms before using it in commercial products.
Is goalbuddy still maintained?
Updated within 6 months. The last commit to goalbuddy was on Oct 2, 2026.
What can I use goalbuddy for?
Running a broad project improvement across many files with verification at each step Preparing a release with checks recorded as receipts Bug hunts that need evidence before a fix is accepted Refactors that must pass tests at defined milestones
How do I install goalbuddy?
Run the one-command setup: npx goalbuddy Restart Codex or Claude Code Prepare a goal in Codex with the goal-prep skill: $goal-prep Run the printed Codex /goal or Claude Code /goalbuddy command to execute the board
Where can I get goalbuddy?
The source code and installation instructions are on GitHub: https://github.com/tolimarchuk/goalbuddy

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects