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/borg, and then runs step 2 for you:

    curl --proto '=https' --tlsv1.2 -fsSL https://install.betterborg.ai | sh

  2. Activate the agent-host integrations:

    borg 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:

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

borg execute hands off reviewed local branches. Add --push or --pr to publish them. borg --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 .borg/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 Aug 31, 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 Aug 31, 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.0.tar.gz (440.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.0-py3-none-any.whl (309.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: betterborg-0.1.0.tar.gz
  • Upload date:
  • Size: 440.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.0.tar.gz
Algorithm Hash digest
SHA256 755d514decde114dbeb3aaba70d2feb4e9837976c3ab2e2a1d2f7c59dca1c3be
MD5 a6bbb67ffca2e73bf3ff6737ca4f84a2
BLAKE2b-256 236e733d1ad811450cbd0be091e1cf7313bbce03cc8e38e017996ea9f971338c

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: betterborg-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 309.1 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5db4f90c0da491803d201ddcbd5ff82d2876e7aa8404f49687a636ed5ab48244
MD5 0d5fe0018d3337b3ec26fd769893fedc
BLAKE2b-256 e3641b14e1500c79fce0d2b661986854e3793cc2f5ea4681d35af2e021221563

See more details on using hashes here.

Provenance

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

0.1.1

2 files

This release

0.1.0 This release

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