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 1, 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 1, 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.1.tar.gz (569.7 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.1-py3-none-any.whl (361.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: betterborg-0.1.1.tar.gz
  • Upload date:
  • Size: 569.7 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.1.tar.gz
Algorithm Hash digest
SHA256 c89605b6aa22d01e1cad1696c2933f998f2c0eebd8c0a27db8c3c4bc39719649
MD5 30e308be2ca2b3ea98cadd4cefda42c0
BLAKE2b-256 08b764f43b763b4eef533bc0fd52bd3884413b2d40eb39f014638b1a0ec384d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for betterborg-0.1.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: betterborg-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 361.6 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 44af2da782887bdc75d69ab28a1b49927a214605dc9815d82389af1d95e83ca2
MD5 27cb2f418fbaae4c6a5a028ef9438fd2
BLAKE2b-256 83ba15280048a25d93af0ca2626e7a06a9029e57eb86af8462036333659da8bf

See more details on using hashes here.

Provenance

The following attestation bundles were made for betterborg-0.1.1-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

0.1.2

2 files

This release

0.1.1 This release

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