A local AI-assisted auto-rebase workflow for long-lived forks.
Project description
auto-rebase-ai
auto-rebase-ai is a local PyPI package for maintaining long-lived forks with
the same four-part architecture described in goal.md, reference.md, and the
diagram in image.png.
auto-rebase = orchestrator
detect-upstream-base = disturbance detection
rebase-assistant = controller
local-test-runner = measurement
The orchestrator finds the fork's current upstream base, resolves a newer target ref, delegates the rebase to the controller, and writes a final report. The controller owns the baseline gate, rebase, conflict handling, Codex repair loop, and summary. The local test runner only measures configured checks.
Install
pipx install auto-rebase-ai
or:
uv tool install auto-rebase-ai
Usage
Inside a forked repository:
auto-rebase init
auto-rebase doctor
auto-rebase run
The default command launches the simple TUI:
auto-rebase
Safety
Version 0.1 never pushes automatically, refuses a dirty working tree except
for generated .auto-rebase/ artifacts, creates a backup branch before rebasing,
and writes repair packets with configured secret redaction.
Release
Before publishing:
uv run --extra dev pytest
uv run --extra dev ruff check .
uv build
Verify the built wheel through the tool-install path:
UV_TOOL_DIR=/tmp/auto-rebase-tool \
UV_TOOL_BIN_DIR=/tmp/auto-rebase-tool-bin \
uv tool install dist/auto_rebase_ai-0.1.0-py3-none-any.whl
/tmp/auto-rebase-tool-bin/auto-rebase init
Publish to PyPI after the package owner has configured credentials:
uv publish
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file auto_rebase_ai-0.1.0.tar.gz.
File metadata
- Download URL: auto_rebase_ai-0.1.0.tar.gz
- Upload date:
- Size: 620.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
369e84529c8fe8611021a69e5b5b94ea17d68cd1b72feb9cebd22dba30ce37ed
|
|
| MD5 |
e2102e904e74fb6a8c9593f099fd88bf
|
|
| BLAKE2b-256 |
8342f10a24c09305a4813bbb8fe6e7b497fa7b510c110f139fab31ad7c243618
|
File details
Details for the file auto_rebase_ai-0.1.0-py3-none-any.whl.
File metadata
- Download URL: auto_rebase_ai-0.1.0-py3-none-any.whl
- Upload date:
- Size: 29.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
86ff8d0df491195cd9b01c30a2203aeee232f892b5bfa626b0d4c5f7c6a4dc5c
|
|
| MD5 |
bfb44d14446158cac63ead997ed6773d
|
|
| BLAKE2b-256 |
fdb8ff77a0ffbd03bca80e35d61bd8798f3b75c2cb2995bb96b6d6dec59f14af
|
