brindle 0.5.4__tar.gz → 0.5.6__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (203) hide show
  1. {brindle-0.5.4 → brindle-0.5.6}/.gitignore +2 -0
  2. {brindle-0.5.4 → brindle-0.5.6}/PKG-INFO +72 -142
  3. {brindle-0.5.4 → brindle-0.5.6}/README.md +71 -141
  4. {brindle-0.5.4 → brindle-0.5.6}/pyproject.toml +3 -1
  5. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/agents.py +90 -15
  6. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/autopilot.py +27 -1
  7. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/developer-local.md +1 -1
  8. brindle-0.5.6/src/brindle/builtin_rules/analysis/doc.md +10 -0
  9. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/cli.py +158 -8
  10. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/company_identity.py +1 -1
  11. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/company_login.py +7 -3
  12. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/api-schema.json +119 -0
  13. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/routes_actions.py +244 -1
  14. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/routes_read.py +140 -3
  15. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/db.py +85 -2
  16. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/doctor.py +31 -6
  17. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/kb.py +43 -8
  18. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/mcp_server.py +85 -7
  19. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/model_access.py +1 -1
  20. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/native/permissions.py +1 -1
  21. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/native/runner.py +20 -1
  22. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/picker.py +3 -1
  23. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pipeline.py +33 -2
  24. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/preflight.py +1 -2
  25. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/account.py +51 -5
  26. brindle-0.5.6/src/brindle/pro/analysis_brief.py +256 -0
  27. brindle-0.5.6/src/brindle/pro/analysis_docs.py +691 -0
  28. brindle-0.5.6/src/brindle/pro/analysis_imports.py +664 -0
  29. brindle-0.5.6/src/brindle/pro/analysis_policy.py +102 -0
  30. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/auth.py +43 -12
  31. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/providers.py +1 -1
  32. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/service/dto.py +3 -0
  33. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/service/inbox.py +80 -4
  34. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/tasks.py +6 -2
  35. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/tmux.py +3 -1
  36. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/workspaces.py +2 -0
  37. {brindle-0.5.4 → brindle-0.5.6}/LICENSE +0 -0
  38. {brindle-0.5.4 → brindle-0.5.6}/SCHEDULE-A +0 -0
  39. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/__init__.py +0 -0
  40. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/__main__.py +0 -0
  41. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/account.py +0 -0
  42. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/airgap.py +0 -0
  43. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/antigravity.py +0 -0
  44. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/assembler.py +0 -0
  45. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/assets/braid_dark.png +0 -0
  46. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/assets/braid_light.png +0 -0
  47. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/budget.py +0 -0
  48. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/__init__.py +0 -0
  49. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/backend-auditor.md +0 -0
  50. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/coordinator.md +0 -0
  51. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/developer-codex.md +0 -0
  52. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/developer-fable.md +0 -0
  53. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/developer-gemini.md +0 -0
  54. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/developer-heavy.md +0 -0
  55. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/developer-light.md +0 -0
  56. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/developer-opencode.md +0 -0
  57. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/developer-sonnet.md +0 -0
  58. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/developer.md +0 -0
  59. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/qa.md +0 -0
  60. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/reviewer-codex.md +0 -0
  61. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/reviewer-gemini.md +0 -0
  62. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/reviewer-local.md +0 -0
  63. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/reviewer-opencode.md +0 -0
  64. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/reviewer.md +0 -0
  65. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/subagent.md +0 -0
  66. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_agents/supervisor.md +0 -0
  67. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_rules/__init__.py +0 -0
  68. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_rules/security/backend.md +0 -0
  69. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_rules/style/minimal-diff.md +0 -0
  70. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/builtin_rules/tests/only.md +0 -0
  71. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/bus.py +0 -0
  72. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/check_scope.py +0 -0
  73. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/ci_adapters.py +0 -0
  74. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/ci_client.py +0 -0
  75. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/ci_federation.py +0 -0
  76. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/ci_hosts.py +0 -0
  77. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/clone.py +0 -0
  78. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/cloud_credential.py +0 -0
  79. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/cloud_login.py +0 -0
  80. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/codemap.py +0 -0
  81. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/codemap_docs.py +0 -0
  82. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/codex_hook.py +0 -0
  83. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/config.py +0 -0
  84. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/conflicts.py +0 -0
  85. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/connections.py +0 -0
  86. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/coordinator.py +0 -0
  87. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/cost.py +0 -0
  88. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/cost_estimate.py +0 -0
  89. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/cull.py +0 -0
  90. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/__init__.py +0 -0
  91. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/app.py +0 -0
  92. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/auth.py +0 -0
  93. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/events.py +0 -0
  94. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/holds.py +0 -0
  95. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/lifecycle.py +0 -0
  96. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/peer.py +0 -0
  97. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/routes_org_permissions.py +0 -0
  98. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/schema.py +0 -0
  99. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/session_review.py +0 -0
  100. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/daemon/terminal.py +0 -0
  101. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/debuglog.py +0 -0
  102. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/demo.py +0 -0
  103. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/detect.py +0 -0
  104. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/entry.py +0 -0
  105. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/escapes.py +0 -0
  106. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/events.py +0 -0
  107. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/gates.py +0 -0
  108. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/git.py +0 -0
  109. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/guardrails.py +0 -0
  110. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/history.py +0 -0
  111. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/identity_lock.py +0 -0
  112. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/inbox.py +0 -0
  113. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/key_check.py +0 -0
  114. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/keys_cmds.py +0 -0
  115. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/keystore.py +0 -0
  116. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/knowledge.py +0 -0
  117. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/launch_health.py +0 -0
  118. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/learned_rules.py +0 -0
  119. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/learning.py +0 -0
  120. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/legacy.py +0 -0
  121. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/local_setup.py +0 -0
  122. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/login_pause.py +0 -0
  123. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/model_availability.py +0 -0
  124. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/native/__init__.py +0 -0
  125. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/native/catalog.py +0 -0
  126. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/native/client.py +0 -0
  127. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/native/loop.py +0 -0
  128. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/native/lsp.py +0 -0
  129. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/native/serve.py +0 -0
  130. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/native/tools.py +0 -0
  131. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/opencode.py +0 -0
  132. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/org_permissions.py +0 -0
  133. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pane_auth.py +0 -0
  134. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/permission_asks.py +0 -0
  135. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/permission_grants.py +0 -0
  136. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/permission_groups.py +0 -0
  137. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/permission_routing.py +0 -0
  138. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/permissions.py +0 -0
  139. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/plugins.py +0 -0
  140. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/policy.py +0 -0
  141. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pool.py +0 -0
  142. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pricing.py +0 -0
  143. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/__init__.py +0 -0
  144. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/_files.py +0 -0
  145. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/audit_chain.py +0 -0
  146. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/audit_export.py +0 -0
  147. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/brief_learning.py +0 -0
  148. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/cost_centers.py +0 -0
  149. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/credentials.py +0 -0
  150. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/features.py +0 -0
  151. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/keys.py +0 -0
  152. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/learning.py +0 -0
  153. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/license.py +0 -0
  154. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/loopback.py +0 -0
  155. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/managed_models.py +0 -0
  156. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/org_profiles.py +0 -0
  157. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/orgkey.py +0 -0
  158. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/rollout.py +0 -0
  159. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/route_health.py +0 -0
  160. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/settings_sync.py +0 -0
  161. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/status.py +0 -0
  162. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/team_events.py +0 -0
  163. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/pro/team_policy.py +0 -0
  164. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/procs.py +0 -0
  165. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/profiles.py +0 -0
  166. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/prompt_answer.py +0 -0
  167. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/provider_homes.py +0 -0
  168. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/providers_install.py +0 -0
  169. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/quota.py +0 -0
  170. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/repo_cmds.py +0 -0
  171. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/repos.py +0 -0
  172. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/rewind.py +0 -0
  173. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/rule_checks.py +0 -0
  174. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/savings.py +0 -0
  175. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/scratch.py +0 -0
  176. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/secrets.py +0 -0
  177. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/self_serve.py +0 -0
  178. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/service/__init__.py +0 -0
  179. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/service/errors.py +0 -0
  180. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/service/permissions.py +0 -0
  181. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/service/routing.py +0 -0
  182. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/service/sessions.py +0 -0
  183. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/services.py +0 -0
  184. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/sessions.py +0 -0
  185. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/sidebar_follow.py +0 -0
  186. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/sidebar_logo.py +0 -0
  187. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/signin_pause.py +0 -0
  188. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/status_cache.py +0 -0
  189. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/updates.py +0 -0
  190. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/upgrade.py +0 -0
  191. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/usage.py +0 -0
  192. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/view.py +0 -0
  193. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/wake.py +0 -0
  194. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/watch.py +0 -0
  195. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/watch_costs.py +0 -0
  196. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/web/__init__.py +0 -0
  197. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/web/chat.py +0 -0
  198. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/web/dashboard.py +0 -0
  199. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/web/diff.py +0 -0
  200. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/web/server.py +0 -0
  201. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/web/static/app.js +0 -0
  202. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/web/static/index.html +0 -0
  203. {brindle-0.5.4 → brindle-0.5.6}/src/brindle/worker_models.py +0 -0
@@ -17,3 +17,5 @@ docs/*
17
17
  commit_msg.txt
18
18
  model_routing_plan.*
19
19
  open_plan.py
20
+
21
+ /node_modules/
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: brindle
3
- Version: 0.5.4
3
+ Version: 0.5.6
4
4
  Summary: Run coding agents in parallel, each on its own git branch, with a supervisor that delegates, reviews, and merges
5
5
  Project-URL: Homepage, https://pawdelta.com/brindle/
6
6
  Project-URL: Documentation, https://pawdelta.com/brindle/docs/recommended-use
@@ -32,9 +32,6 @@ Description-Content-Type: text/markdown
32
32
 
33
33
  # brindle
34
34
 
35
- *[pawdelta.com/brindle](https://pawdelta.com/brindle/) · Published on PyPI as `brindle`; the command is `brindle`. This project is
36
- unrelated to the Brindle desktop app at brindle.dev.*
37
-
38
35
  A supervisor for your coding agents that won't call work done until it's proven.
39
36
  brindle runs Claude Code, Codex and open-weight models side by side, each in its own
40
37
  git worktree. A supervisor agent splits up the work and hands it out. Each branch
@@ -42,28 +39,52 @@ merges only after a reviewer approves
42
39
  that exact commit and your checks pass. A goal is done only when its check commands
43
40
  exit 0.
44
41
 
42
+ **Who it's for:** developers who already use Claude Code, Codex or Google Antigravity
43
+ and want several agents working in parallel on one repo, with a review and a test
44
+ gate before anything merges. For a one-line fix, plain `claude` is quicker
45
+ ([Recommended use](#recommended-use)).
46
+
47
+ **What it adds over running the CLI directly:** a worktree and branch per worker,
48
+ merges gated on a reviewer's approval of the exact commit plus your checks, goals
49
+ that count as done only when their check commands exit 0, and a session that keeps
50
+ going, pauses at your usage limit and resumes after the reset, until those checks pass.
51
+
45
52
  ```sh
46
- curl -fsSL pawdelta.com/brindle/install | sh # installs uv and tmux if missing, then brindle
53
+ curl -fsSL pawdelta.com/brindle/install | sh # installs uv (and tmux on macOS) if missing, then brindle
47
54
  # or, if you already have uv and tmux:
48
55
  uv tool install brindle
49
56
 
50
57
  brindle demo # watch it finish a practice repo in a few minutes
51
58
  ```
52
59
 
53
- brindle is free to use, including at work, under the [brindle License 1.0](LICENSE): you
54
- may install and run it, but not modify or redistribute it or use it to build a competing
55
- service ([details](#license)).
60
+ macOS, Linux, or Windows through WSL2. You need tmux and at least one agent CLI,
61
+ installed and signed in ([Install](#install)).
62
+
63
+ **License:** source-available, not open source. brindle is free to use, including at
64
+ work, under the [brindle License 1.0](LICENSE): you may install and run it, but not
65
+ modify it (beyond the changes the license permits) or redistribute it, or use it to
66
+ build a competing service ([details](#license)).
67
+
68
+ **Free and paid:** the core workflow is free, with no plan limit on agents, workers or
69
+ sessions (by default up to 5 workers at once per session, set by `max_agents`), and
70
+ Free needs no account. brindle Pro is $20/month; brindle Team is $40/seat/month,
71
+ up to 20 seats ([what each adds](#brindle-pro-and-team),
72
+ [pricing](https://pawdelta.com/brindle/pricing/)).
56
73
 
57
74
  ![brindle demo: a supervisor splits a goal between two workers, each branch is reviewed and merged, and both milestones turn green once their checks pass](https://raw.githubusercontent.com/PawDelta/brindle/main/assets/brindle-demo.gif)
58
75
 
59
76
  *`brindle demo`, recorded on brindle 0.4.1 (sped up about 2.7×, 20 seconds): two workers in parallel, each branch reviewed and merged, both milestones verified by their check commands.*
60
77
 
78
+ Website: [pawdelta.com/brindle](https://pawdelta.com/brindle/) · Published on PyPI as
79
+ `brindle`; the command is `brindle`.
80
+
61
81
  - **Done means a command passed.** A goal is split into milestones, each with a
62
82
  check command that brindle runs itself. A milestone is verified when its check exits
63
83
  0, re-run after later merges to catch regressions, never when a model says so.
64
84
  - **Reviewed before it merges.** A reviewer approves the exact sha, then
65
- pre-commit and your `checks` run. Codex reviews Claude's work (or a local model
66
- does) when available. Nothing reaches your default branch on its own.
85
+ pre-commit and your `checks` run. The default reviewer is Claude; set
86
+ `review_profile` to `reviewer-codex` or `reviewer-local` for a second model's
87
+ view. Nothing reaches your default branch on its own.
67
88
  - **Parallel agents, no collisions.** Every worker gets its own worktree and
68
89
  branch, cut from a freshly fetched base, with its own block of ports and
69
90
  optional per-worktree databases (brindle Pro).
@@ -85,8 +106,10 @@ service ([details](#license)).
85
106
  curl -fsSL pawdelta.com/brindle/install | sh
86
107
  ```
87
108
 
88
- The script ([scripts/install.sh](scripts/install.sh)) installs uv and tmux if
89
- they're missing, then brindle, then runs `brindle doctor`. Run it again to upgrade.
109
+ The script ([scripts/install.sh](scripts/install.sh)) installs uv if it's missing
110
+ and tmux if it's missing (with Homebrew on macOS; elsewhere it prints the command to
111
+ run), then brindle (Python 3.11 or newer, which uv fetches if needed), then runs
112
+ `brindle doctor`. Run it again to upgrade.
90
113
  Session starts check PyPI at most once a day and show available updates in the status
91
114
  bar and `brindle doctor`; set `"auto_update": true` in `~/.brindle/config.json` to
92
115
  upgrade in the background (restart to use it). Checks skip local and editable
@@ -99,12 +122,15 @@ uv tool install brindle
99
122
  uv tool install --editable ~/Projects/brindle # or from a local checkout
100
123
  ```
101
124
 
102
- brindle drives Claude Code, so you need that too (`npm install -g @anthropic-ai/claude-code`).
125
+ brindle drives the agent CLIs you already use, so you need at least one installed and
126
+ signed in. Claude Code is the default for the supervisor, workers and reviewer
127
+ (`npm install -g @anthropic-ai/claude-code`, then `claude auth login`); Codex
128
+ (`brindle -s codex` makes it the supervisor) and Google Antigravity work too.
103
129
 
104
- There's also a free brindle desktop app for macOS, Linux, and Windows (via WSL). It's a download from the brindle website and runs on the same engine; the CLI keeps working alongside it. `brindle app` opens the app, or prints the download link if it isn't installed. `brindle daemon` runs the local API the app talks to: over a Unix socket by default, or on `--tcp` at 127.0.0.1 for WSL. Over `--tcp` the daemon can't check whether a caller is an agent, so its token is the only gate: keep TCP for the WSL client.
130
+ There's also a free brindle desktop app for macOS and Linux (on Windows, use the CLI inside WSL2). It's a download from the brindle website and runs on the same engine; the CLI keeps working alongside it. `brindle app` opens the app, or prints the download link if it isn't installed. `brindle daemon` runs the local API the app talks to: over a Unix socket by default, or on `--tcp` at 127.0.0.1 for WSL. Over `--tcp` the daemon can't check whether a caller is an agent, so its token is the only gate: keep TCP for the WSL client.
105
131
 
106
132
  `brindle --version` prints the installed version; the tmux status bar of every brindle
107
- session shows it too (`brindle 0.4.3`). A session started before an upgrade keeps
133
+ session shows it too (`brindle 0.5.6`). A session started before an upgrade keeps
108
134
  running the old code, and shows the old number, until you restart it.
109
135
 
110
136
  ## Quick start
@@ -314,10 +340,12 @@ or put the goal in `.brindle/goals.md`, and it works like a project manager:
314
340
  reviewer agent has approved that exact commit, your pre-commit hooks pass,
315
341
  and your `checks` pass. brindle runs these itself before `merge_workspace`,
316
342
  and caches a clean commit's passing result so it isn't re-run for every
317
- review and merge attempt at the same sha. `request_review` starts the
318
- reviewer immediately and runs `checks` in the background, delivering a
319
- pass/fail summary (output only for failures) as a message once they
320
- finish, instead of asking the reviewer to run the whole suite itself.
343
+ review and merge attempt at the same sha. `request_review` returns at
344
+ once. With `checks` configured, brindle runs them first, in the
345
+ background, and starts the reviewer when they finish, with a pass/fail
346
+ summary (output only for failures) in its prompt, instead of asking the
347
+ reviewer to run the whole suite itself. With no `checks`, the reviewer
348
+ starts right away.
321
349
  `request_review` picks the reviewer profile itself unless you pass one: an
322
350
  explicit `profile` argument, else `review_profile` in the repo config,
323
351
  else `reviewer` (the repo's `reviewer` setting). brindle never picks a
@@ -1066,7 +1094,9 @@ brindle is complete on its own. brindle Pro adds hosted learning (which profile
1066
1094
  to use for which kind of task; per person on Pro, per organization on Team,
1067
1095
  and kept private) and brindle Team adds org policies (allowed providers
1068
1096
  and models, human review before merges) and an audit feed of what brindle did.
1069
- Plans and prices: https://pawdelta.com/brindle#pricing.
1097
+ Free needs no account. brindle Pro is $20/month and brindle Team $40/seat/month, up
1098
+ to 20 seats; brindle Enterprise is by contact. Plans and prices:
1099
+ https://pawdelta.com/brindle/pricing/.
1070
1100
 
1071
1101
  Run `brindle account` to see every paid feature, which ones your plan includes,
1072
1102
  how to use them, and the next step to get the rest:
@@ -1077,23 +1107,17 @@ how to use them, and the next step to get the rest:
1077
1107
  | per-worktree services | Pro | `"services"` in `.brindle/config.json` |
1078
1108
  | several repos in one session | Pro | `brindle repo add <path>` |
1079
1109
  | settings sync across machines | Pro | `brindle account sync` |
1080
- | Brindle-CI build fixing (the fix workflow) | Pro | `brindle ci init` |
1081
1110
  | learned rules from repeated review findings | Pro | `brindle rules suggest` |
1082
1111
  | cost (estimates, budgets, reports) | Pro | `brindle cost report` |
1083
1112
  | guardrails (write scope, read scope, env allowlist per profile) | Pro | `write_scope`, `read_scope`, `env_allow` in a profile |
1084
1113
  | org policies + audit feed | Team | `brindle account org policy` |
1085
- | Brindle-CI (fixes builds, issues into verified pull requests, validation) | Team | `brindle ci init` |
1086
1114
  | org profile and rule-pack library, pinned so a repo can't loosen it | Team | `brindle account org profiles` |
1087
1115
  | org budgets and protected paths | Team | `budget`, `protected_paths` in your org policy (`brindle account org policy`) |
1088
1116
  | per-member budgets, pause, and admin messages (sidebar "Messages", the bottom bar, `brindle org messages`) | Team | `brindle org messages [--keep]` lists and marks read the notices your admins sent you; a pause refuses new workers and stops running ones |
1089
1117
  | audit log, air-gap | Enterprise | `brindle audit verify`, `"airgap": true` |
1090
1118
  | audit export | Enterprise | `"audit_export"` in `~/.brindle/config.json`, `brindle audit ship` |
1091
1119
  | managed models | Enterprise | `agent_setup` routes with `enforce`, and `deny_personal_keys`, in your org policy (see "Managed models" below) |
1092
- | wider CI, cost centers, managed rollout | Enterprise | `brindle ci init --host gitlab`, `brindle cost request`, and `min_version`, required packs and the kill switch in your org policy; admins can also shut down or throttle a member, role or org remotely (it arrives within about a minute) |
1093
-
1094
- `brindle ci init` checks your plan before it changes anything: it refuses
1095
- without Brindle-CI on the org you're using, and on Pro it sets up only the fix
1096
- workflow.
1120
+ | cost centers, managed rollout | Enterprise | `brindle cost request`, and `min_version`, required packs and the kill switch in your org policy; admins can also shut down or throttle a member, role or org remotely (it arrives within about a minute) |
1097
1121
 
1098
1122
  ```sh
1099
1123
  brindle account # paid features: what you have, how to use them, how to get the rest
@@ -1383,109 +1407,7 @@ brindle audit ship [--force] # send now; exit 1 if a sink
1383
1407
  brindle audit prune [--repo PATH] [--days N] # prune now (default: retention_days)
1384
1408
  ```
1385
1409
 
1386
- ### Brindle-CI
1387
-
1388
- Brindle-CI (brindle Team; build fixing alone is on Pro) brings brindle into your CI: it fixes broken builds,
1389
- turns issues into pull requests whose checks it has verified, and reviews pull
1390
- requests with evidence. It runs on your own CI with your own model keys; the
1391
- hosted control plane decides what each run does and what it reports. The
1392
- workflows call these commands:
1393
-
1394
- - `brindle ci init`: set a repository up in one go (the GitHub App, the secrets,
1395
- the workflows as a pull request, then a doctor check). Run it inside a
1396
- checkout of the repository. For Claude it asks whether to use an API key
1397
- (the `ANTHROPIC_API_KEY` secret) or Anthropic
1398
- [workload identity federation](https://platform.claude.com/docs/en/manage-claude/wif-reference)
1399
- (`--credential key|federation` answers without asking). It also creates the
1400
- `brindle` issue label (label an issue with it to hand it to brindle CI), and
1401
- commits the workflows on a `brindle/ci-setup` branch, then puts you back on
1402
- the branch you started on and deletes the local setup branch, so `git pull`
1403
- after merging the setup pull request is clean (commit or stash your changes
1404
- first: it refuses to start with uncommitted work). With your own cloud
1405
- (`--credential bedrock|vertex|foundry`, keyless GitHub OIDC) it can read the
1406
- IDs from the deployment template's outputs instead of asking:
1407
- `--from-stack NAME [--region R]` (AWS CloudFormation), `--from-terraform DIR`
1408
- (Google) or `--from-deployment NAME -g RG` (Azure). They are defaults for
1409
- `--cloud-var`, which still overrides them, and every ID is format-checked. A
1410
- missing `aws`, `terraform` or `az` CLI or output is an error that names the
1411
- `--cloud-var` to pass instead. Vertex AI and Microsoft Foundry are in
1412
- **preview** (not yet verified end to end): `init` refuses them unless you pass
1413
- `--preview` or set `BRINDLE_CI_PREVIEW_CLOUDS=1`, and `doctor` marks them
1414
- `(preview)`. Bedrock is generally available.
1415
- - `brindle ci doctor`: which provider CLIs and credential names a runner has, and
1416
- which providers CI may use on this repository. `--models` also makes one tiny
1417
- call per pinned model and says why any is refused (a quota, a form not filled in).
1418
- - `brindle ci start`: start a run for an issue, a goal text or a dispatched run,
1419
- or a validation of a pull request.
1420
- - `brindle ci run`: run what was started: the supervisor and the result upload,
1421
- or the pull request's checks and reviews and the evidence upload.
1422
- - `brindle ci report`: tell the service how the workflow's jobs ended.
1423
-
1424
- Credential names are reported, never values. CI uses API keys, cloud sign-ins
1425
- (Bedrock, Vertex, Foundry) or identity federation only: a provider signed in
1426
- only with a subscription (`CLAUDE_CODE_OAUTH_TOKEN`, a Codex ChatGPT login) is
1427
- not used, on personal and organization repositories alike. Add an API key
1428
- secret instead.
1429
-
1430
- Fix builds only fix the default branch's *required* status checks, and a new
1431
- repository has none. When the default branch requires none, `brindle ci init`
1432
- warns and, for each job in your workflows, asks whether to make it required
1433
- (`--required-check NAME` picks one without asking, `--no-required-check` only
1434
- warns; run without a terminal, init only makes a check required when
1435
- `--required-check` names it). It adds the check to the branch's existing protection, or protects the
1436
- branch with just that check. GitHub only allows branch protection on a private
1437
- repository with a paid plan; when it refuses, init says how to require the
1438
- check yourself (Settings > Branches, "Require status checks to pass").
1439
-
1440
- An Anthropic API key is either a workspace key (scoped to one workspace) or an
1441
- organization-level key (not scoped to a workspace). An organization-level key
1442
- needs the workspace in every request, so after the key `brindle ci init` asks for
1443
- its workspace ID (`wrkspc_...`; leave it blank for a workspace key, or pass
1444
- `--workspace-id`, default `$ANTHROPIC_WORKSPACE_ID`) and stores it as the Actions
1445
- variable `ANTHROPIC_WORKSPACE_ID`. The workflow then sets
1446
- `ANTHROPIC_CUSTOM_HEADERS="anthropic-workspace-id: <id>"`, which reaches every
1447
- Claude Code process the run starts.
1448
-
1449
- With identity federation the repository stores no Anthropic key: the workflow
1450
- exchanges GitHub's OIDC token once for a short-lived Anthropic token, as a
1451
- Claude Console service account (billed as API, so it is allowed on
1452
- organization repositories), and gives the job `ANTHROPIC_AUTH_TOKEN`. `brindle
1453
- ci init` stores the rule, organization, service account and optional workspace
1454
- IDs as the Actions variables `ANTHROPIC_FEDERATION_RULE_ID`,
1455
- `ANTHROPIC_ORGANIZATION_ID`, `ANTHROPIC_SERVICE_ACCOUNT_ID` and
1456
- `ANTHROPIC_WORKSPACE_ID`, from `--rule-id`, `--organization-id`,
1457
- `--service-account-id` and `--workspace-id` or else asked (defaulting to those
1458
- environment variables). Without a terminal on stdin, init asks nothing and
1459
- takes the options and the environment, so it can run unattended; a missing or
1460
- malformed ID (rule `fdrl_...`, organization a UUID, service account
1461
- `svac_...`, workspace `wrkspc_...`) stops it before it creates the CI token.
1462
- The ID options imply `--credential federation` and can't be combined with
1463
- `--credential key`. Create the federation rule in the Claude Console with
1464
- subject prefix `repo:<owner>/<name>:*`, the condition
1465
-
1466
- ```text
1467
- claims.repository == "<owner>/<name>" && claims.workflow_ref.startsWith("<owner>/<name>/.github/workflows/brindle-ci-")
1468
- ```
1469
-
1470
- audience `https://api.anthropic.com`, and a token lifetime of at least 600
1471
- seconds. The condition lets only brindle's workflows mint tokens. On pull
1472
- requests the pull request's own copy of the validate workflow runs, so give
1473
- write access only to people you trust (forks never get a token). Leave the `ANTHROPIC_API_KEY` secret
1474
- unset: a key takes precedence (brindle drops an empty one before Claude Code
1475
- starts).
1476
-
1477
- A federated token lives at most about ten minutes, however long the rule
1478
- allows: Anthropic caps it at twice what remains of GitHub's OIDC token. So
1479
- the run job doesn't rely on the workflow's one exchange: `brindle ci run`
1480
- fetches a fresh OIDC token and exchanges it again at 70% of each token's
1481
- life, and lends the current token to the agents through a proxy on the
1482
- runner's loopback interface. The agents get `ANTHROPIC_BASE_URL` pointing at
1483
- it and a random per-run secret as `ANTHROPIC_AUTH_TOKEN`; the Anthropic token
1484
- itself stays in the `brindle ci run` process, and the GitHub token endpoint
1485
- (`ACTIONS_ID_TOKEN_REQUEST_URL` and its token) is scrubbed before any agent or
1486
- check starts. If the first exchange fails, the run goes on with the
1487
- workflow's token as before; `BRINDLE_CI_FEDERATION_REFRESH=0` in the job's
1488
- environment turns the refresh off.
1410
+ ## Cleanup, merging and workspace config
1489
1411
 
1490
1412
  **Closing and cleaning up.** Press `x` on an agent in the sidebar (twice for one
1491
1413
  that's still running) or run `brindle close <id>` to stop it and hide it. Stopping means
@@ -1504,8 +1426,10 @@ removes stale locks and empty worktree folders.
1504
1426
  **The pipeline.** The slow part of delegating isn't the workers, it's the supervisor's
1505
1427
  turns between the stages: report, review, merge, remove, each waiting on a model turn
1506
1428
  that carries the whole session's context. So brindle runs those stages itself. When a
1507
- worker reports, brindle starts the review at once and runs the checks in the
1508
- background; when the reviewer approves and the checks pass, brindle merges the branch,
1429
+ worker reports, brindle gets the branch reviewed at once: with `checks` configured it
1430
+ runs them first, in the background, and starts the reviewer when they finish, with
1431
+ their results in its prompt (with no `checks`, the reviewer starts right away). When
1432
+ the reviewer approves and the checks pass, brindle merges the branch,
1509
1433
  removes the worktree, and sends the supervisor one message with the worker's report
1510
1434
  and the review. Findings go straight back to the worker to fix (`review_rounds`
1511
1435
  times) before they reach the supervisor, and anything the pipeline can't settle (a
@@ -1528,11 +1452,13 @@ merges. Conflicts in `protected_paths` (migrations, lockfiles, generated code) a
1528
1452
  never handed to a worker: the supervisor gets them as "needs you".
1529
1453
 
1530
1454
  **The completion audit.** A milestone's check can pass without the milestone being
1531
- done: the test asserts too little, or checks the wrong thing. So when every milestone
1532
- passes, brindle doesn't call the goal reached yet. A read-only reviewer audits everything since the goal was set
1533
- against the goal and each milestone, looking for what's missing, stubbed or weakly
1534
- tested. Only its approval of that commit finishes the goal. If it finds gaps, the
1535
- supervisor gets them as a message and keeps working until a fresh audit approves.
1455
+ done: the check tests the wrong thing, or the deliverable was never built. So when
1456
+ every milestone passes, brindle doesn't call the goal reached yet. A read-only
1457
+ reviewer audits everything since the goal was set against the goal and each
1458
+ milestone, looking for deliverables that are missing, stubbed out or unhandled. It
1459
+ trusts the passing checks and doesn't debate how deep the tests go. Only its
1460
+ approval of that commit finishes the goal. If it finds gaps, the supervisor gets
1461
+ them as a message and keeps working until a fresh audit approves.
1536
1462
  `"goal_audit": false` turns it off.
1537
1463
 
1538
1464
  **Spending fewer tokens.** Workers run only the tests that cover their change while
@@ -1663,7 +1589,7 @@ it's signed in without a plan that includes it, is reported to its supervisor.
1663
1589
  | Provider | Key login (environment variables) |
1664
1590
  |---|---|
1665
1591
  | `claude` | yes: `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN`, or Bedrock/Vertex/Foundry (`CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`) |
1666
- | `codex` | yes: `OPENAI_API_KEY`, `CODEX_API_KEY`. With Codex signed in with ChatGPT (checked on Codex CLI 0.162.0): interactive `codex`, which brindle runs in agent panes, ignores both keys and uses the ChatGPT plan, and only `codex login --with-api-key` switches it to a key; headless `codex exec` (Brindle-CI) bills `CODEX_API_KEY` over the login and ignores `OPENAI_API_KEY`. `brindle doctor` and `brindle keys set` say so, and `auth: api_key` on an interactive Codex profile is refused under a ChatGPT login (run `codex login --with-api-key`, or use `auth: subscription`) |
1592
+ | `codex` | yes: `OPENAI_API_KEY`, `CODEX_API_KEY`. With Codex signed in with ChatGPT (checked on Codex CLI 0.162.0): interactive `codex`, which brindle runs in agent panes, ignores both keys and uses the ChatGPT plan, and only `codex login --with-api-key` switches it to a key; headless `codex exec` bills `CODEX_API_KEY` over the login and ignores `OPENAI_API_KEY`. `brindle doctor` and `brindle keys set` say so, and `auth: api_key` on an interactive Codex profile is refused under a ChatGPT login (run `codex login --with-api-key`, or use `auth: subscription`) |
1667
1593
  | `antigravity` | `GEMINI_API_KEY`, only with `"modelProvider": "gemini"` in `agy`'s `settings.json` (see [Google Antigravity](#google-antigravity)); otherwise `agy`'s own browser sign-in |
1668
1594
  | `opencode` | whatever the model's provider takes (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, ...), or `opencode auth login`; its free `opencode/...` models need neither |
1669
1595
 
@@ -2063,9 +1989,9 @@ about 20 GB of GPU memory, so set `"local_models": false` if you don't want brin
2063
1989
  to start or preload one. When `brindle` (or `brindle continue`)
2064
1990
  starts and a native profile points at Ollama on this machine that isn't answering,
2065
1991
  brindle starts it in the background with `OLLAMA_CONTEXT_LENGTH` set to the largest
2066
- `context_tokens` any profile asks of it plus room for the reply (40960 for the
2067
- built-ins), then loads each profile's model so the first task doesn't wait on the
2068
- read from disk. Its output goes to `~/.brindle/ollama.log`. Only Ollama on a
1992
+ `context_tokens` any profile asks of it plus room for the reply (40192 for the
1993
+ built-ins: `32k` is 32000, plus 8192), then loads each profile's model so the
1994
+ first task doesn't wait on the read from disk. Its output goes to `~/.brindle/ollama.log`. Only Ollama on a
2069
1995
  loopback address is started; a remote endpoint is yours to run. A server you
2070
1996
  started yourself (with whatever settings) is left alone.
2071
1997
 
@@ -2472,6 +2398,10 @@ The pre-push hook that ran these before every push is off for now
2472
2398
  ## License
2473
2399
 
2474
2400
  brindle is source-available, not open source: you may install and use it under the
2475
- [brindle License 1.0](LICENSE), which does not allow changing or redistributing it,
2401
+ [brindle License 1.0](LICENSE), which does not allow changing it (beyond the
2402
+ permitted changes it lists: contributions, configuration and plugins, private fixes)
2403
+ or redistributing it,
2476
2404
  using it for the competing services listed in [SCHEDULE-A](SCHEDULE-A), or getting
2477
2405
  around paid-feature checks.
2406
+
2407
+ This project is unrelated to the Brindle desktop app at brindle.dev.