Betterborg CLI

PyPI npm Python License

Betterborg is an AI engineering team for substantial software projects, not a chat window that makes an isolated edit. You give it a task or a PRD; agents investigate your real code, write a reviewed technical plan, decompose it into a dependency graph of tasks, and implement them, each in its own isolated Git worktree. You approve the plan before anything is decomposed, and the estimate before anything runs. It works locally, on your own Claude Code or Codex subscription.

[!NOTE] Pre-alpha. Interfaces may change between releases.

Get started

  1. Install the CLI:

    pip install betterborg

    Or install the standalone release binary for Darwin or Linux, which needs no Python toolchain. It selects ARM64 or x86_64 from the release manifest, verifies the SHA-256 digest and exact version before replacing ~/.local/bin/betterborg, and then runs step 2 for you:

    curl -fsSL https://install.betterborg.ai | sh

  2. Activate the agent-host integrations:

    betterborg plugins install --all

    Then run /reload-plugins in any open Claude Code session, and start a new Codex session when prompted.

  3. From inside a Git repository, run the loop:

    betterborg trust                     # trust this worktree (machine-local)
betterborg init                      # register and analyze the repository
betterborg create my-feature         # or: betterborg create my-feature --prd spec.md
betterborg plan start my-feature     # agents plan, review, and iterate
betterborg plan approve my-feature   # your gate: nothing is decomposed before this
betterborg task estimate my-feature  # P50/P80 work and cost
betterborg execute my-feature        # approve the estimate, then run

betterborg execute hands off reviewed local branches. Add --push or --pr to publish them. betterborg --help is the full command index.

To try it without installing:

npx --yes @betterborg/cli version

Plugin activation needs a persistent install, so it is skipped under npx.

Requirements

  • Python 3.11+, on macOS or Linux. On Windows, use a WSL2 shell.
  • One agent transport: a claude or codex CLI on PATH and already logged in, or ANTHROPIC_API_KEY / OPENAI_API_KEY exported in your shell.

Keep provider keys in your shell or a secret manager, never in .betterborg/config.toml or any tracked file.

Documentation

Reporting bugs

File a GitHub issue.

Contributing

See AGENTS.md for repository rules and the standard make targets.

License

Copyright 2026 Betterborg. Licensed under the MIT License. See NOTICE for attribution.

Project links

Data verified by PyPI on Sep 3, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for betterborg from gravatar.com betterborg

Credits

Author: Betterborg

GitHub Statistics

Data verified by PyPI on Sep 3, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

betterborg-0.1.2.tar.gz (576.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

betterborg-0.1.2-py3-none-any.whl (362.9 kB view details)

Uploaded Python 3

File details

Details for the file betterborg-0.1.2.tar.gz.

File metadata

  • Download URL: betterborg-0.1.2.tar.gz
  • Upload date:
  • Size: 576.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for betterborg-0.1.2.tar.gz
Algorithm Hash digest
SHA256 3ea2eb4443176f499b335f66d383f2500a82cda4fbe866ae8473ef117ca870d6
MD5 8f729a7990dab5468c7b489bc9277e7c
BLAKE2b-256 440b7d018fbff88641310c71fc1f45660eff8459ee0b69fc27987dea262f32f7

See more details on using hashes here.

Provenance

The following attestation bundles were made for betterborg-0.1.2.tar.gz:

Publisher: release.yml on betterborg/betterborg-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file betterborg-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: betterborg-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 362.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for betterborg-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1cca0a4872ed39ebb0e606b2d4f97014215eaaa800c0b299b00c350bdb1703cb
MD5 7f06509c2ed04492ac0226617073edee
BLAKE2b-256 cff56b109826baad69fdac4fee5943bc34ef8e9a02bf8b408364560f055a7a8b

See more details on using hashes here.

Provenance

The following attestation bundles were made for betterborg-0.1.2-py3-none-any.whl:

Publisher: release.yml on betterborg/betterborg-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.2.1

2 files

0.2.0

2 files

This release

0.1.2 This release

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page