[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-11071":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},11071,"goalbuddy","tolibear\u002Fgoalbuddy","tolibear","A better \u002Fgoal for Codex and Claude Code","",null,"JavaScript",699,56,5,3,0,21,69,284,63,9.27,"MIT License",false,"main",true,[],"2026-06-12 02:02:29","# GoalBuddy\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgoalbuddy.dev\">\n    \u003Cimg src=\"internal\u002Fassets\u002Fgoalbuddy-v0.3.5-release.png\" alt=\"GoalBuddy v0.3.5 release: Subgoals, parallel agents, and dark mode.\" width=\"100%\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>A simple operating loop for long \u003Ccode>\u002Fgoal\u003C\u002Fcode> runs.\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fgoalbuddy\">\u003Cimg alt=\"npm\" src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fgoalbuddy?style=flat-square&color=684cff\">\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg alt=\"MIT License\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-071236?style=flat-square\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgoalbuddy.dev\">\u003Cimg alt=\"goalbuddy.dev\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fsite-goalbuddy.dev-684cff?style=flat-square\">\u003C\u002Fa>\n\u003C\u002Fp>\n\nGoalBuddy helps Codex and Claude Code stay oriented during long coding tasks, especially when the work branches into subgoals, parallel agents, and long-running verification.\n\nIt gives `\u002Fgoal` a small local workspace: a charter, a board, notes, receipts, and a clear next task. The work stays in your repo, so a run can pause, resume, verify, and keep going without re-inventing the plan every turn.\n\n## Start Here\n\nRun one command:\n\n```bash\nnpx goalbuddy\n```\n\nRestart Codex or Claude Code.\n\nThen prepare a goal:\n\n```text\n$goal-prep\n```\n\nIn Claude Code, use:\n\n```text\n\u002Fgoal-prep\n```\n\nGoal Prep creates the board and prints the exact `\u002Fgoal` command to run next. That is the whole path.\n\n## Codex Install Model\n\nFor Codex, the canonical install is the native plugin plus bundled agents:\n\n```text\n~\u002F.codex\u002Fplugins\u002Fcache\u002Fgoalbuddy\u002Fgoalbuddy\u002F\u003Cversion>\u002F\n~\u002F.codex\u002Fagents\u002Fgoal_judge.toml\n~\u002F.codex\u002Fagents\u002Fgoal_scout.toml\n~\u002F.codex\u002Fagents\u002Fgoal_worker.toml\n```\n\nThe Codex plugin bundles `$goal-prep`; a clean Codex install should not need personal `~\u002F.codex\u002Fskills\u002Fgoalbuddy` or `~\u002F.codex\u002Fskills\u002Fgoal-maker` folders. Native Codex `\u002Fgoal` is a separate OpenAI-gated feature. GoalBuddy prepares local boards and handoff prompts for it, but it does not enable or replace native `\u002Fgoal`.\n\nTo verify a Codex install:\n\n```bash\nnpx goalbuddy doctor --target codex --goal-ready\n```\n\n## What It Creates\n\n```text\ndocs\u002Fgoals\u002F\u003Cyour-goal>\u002F\n  goal.md\n  state.yaml\n  notes\u002F\n  subgoals\u002F        # optional depth-1 child boards\n```\n\n`goal.md` says what you want.\n\n`state.yaml` tracks the board.\n\n`notes\u002F` keeps longer findings out of the main thread.\n\n`subgoals\u002F` holds optional child boards when one parent task needs a bounded branch of work.\n\n## How It Thinks\n\n```text\nrough idea -> goal prep -> \u002Fgoal -> scout -> judge -> worker -> receipt -> verify\n```\n\nScout maps the repo.\n\nJudge chooses the largest safe useful slice.\n\nWorker completes the whole assigned slice and leaves a receipt.\n\n`\u002Fgoal` keeps the loop honest until the original goal is actually done.\n\n## Slice Sizing\n\nSafe does not mean small. Safe means bounded, explicit, verified, and reversible.\n\nGoalBuddy should not optimize for tiny safe tasks. It should optimize for the largest safe useful slice: a working screen, working API path, data pipeline step, backend vertical slice, real bug fix, or milestone review. The board warns when it sees safe-looking work that keeps adding helpers, contracts, proof files, or doc notes without moving the outcome.\n\n## Subgoals, Parallel Agents, and Dark Mode\n\nGoalBuddy keeps the model small:\n\n- `state.yaml` is the source of truth.\n- A board is a view of one `state.yaml`.\n- The local hub is a switchboard for many boards.\n- A subgoal is one depth-1 `state.yaml` linked from a parent task.\n- Settings are viewer preferences, not workflow state.\n\nUse subgoals for bounded child work that belongs to a parent task. Use multiple local boards when parallel agents or separate goal runs are active at the same time. Keep the board open in light or dark mode while the work moves.\n\n## Execution Quality\n\nGoalBuddy can prepare safe parallel work; it does not run a parallel org chart.\n\nUse `goalbuddy prompt docs\u002Fgoals\u002F\u003Cslug>` to render a compact prompt for the active task without dumping the whole state file. The prompt includes a mandatory `required_spawn_agent_type`; Codex PMs should use that exact GoalBuddy agent (`goal_scout`, `goal_worker`, or `goal_judge`) instead of a generic role agent. Use `goalbuddy parallel-plan docs\u002Fgoals\u002F\u003Cslug>` to inspect read-only or disjoint write-scope work that can be handed to native Codex or Claude Code agent flows. The command reports recommendations only; it does not mutate state or spawn agents.\n\n## Update\n\nWhen a new GoalBuddy version ships:\n\n```bash\nnpx goalbuddy update\n```\n\nThat updates both Codex and Claude Code.\n\n## Live Boards\n\nGoalBuddy can open a local board while the work is running, so you can see the plan, active task, receipts, subgoals, and verification status without digging through the chat.\n\nMultiple local boards reuse one readable `goalbuddy.localhost` hub with an in-header board switcher. When sharing a board in chat or docs, use a real Markdown link such as `[Open GoalBuddy board](http:\u002F\u002Fgoalbuddy.localhost:41737\u002F\u003Cslug>\u002F)` so the URL is clickable. The viewer also supports dark mode, compact mode, completed-task collapse, active-work motion, and reduced-motion handling.\n\nSee [GoalBuddy 0.3.5: Subgoals, Parallel Agents, and Dark Mode](RELEASE-0.3.5.md) for the release notes.\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"internal\u002Fassets\u002Fgoalbuddy-live-board.jpg\" alt=\"GoalBuddy local live board open next to Codex while Scout, Judge, and Worker tasks populate.\" width=\"100%\">\n\u003C\u002Fp>\n\n## Good For\n\n- broad project improvements\n- release prep\n- bug hunts that need evidence\n- refactors with verification steps\n- anything too large for one prompt\n\n## For This Repo\n\nGoalBuddy is MIT licensed and published on npm.\n\nThe implementation lives in this repo, but the happy path is intentionally tiny: install it, run Goal Prep, then let `\u002Fgoal` work from the generated files.\n\nFor release process details, see [RELEASE.md](RELEASE.md).\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F?repos=tolibear%2Fgoalbuddy&type=date&legend=top-left\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=tolibear\u002Fgoalbuddy&type=date&theme=dark&legend=top-left\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=tolibear\u002Fgoalbuddy&type=date&legend=top-left\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=tolibear\u002Fgoalbuddy&type=date&legend=top-left\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n## License\n\nMIT\n","GoalBuddy 是一个为 Codex 和 Claude Code 设计的简化操作循环工具，旨在处理长时间的编码任务。它通过提供一个小型本地工作空间（包括章程、看板、笔记和收据等）来帮助开发者在分支子目标、并行代理和长期验证过程中保持方向。该工具支持暂停、恢复和持续验证，无需每次重新规划。基于 JavaScript 开发，采用 MIT 许可证。适用于需要进行复杂且耗时较长的编程项目场景，如软件开发中的多阶段任务管理与协作。",2,"2026-06-11 03:31:07","CREATED_QUERY"]