project-sandbox-tui
A vim/ranger-style terminal UI for running coding agents in project-sandbox containers, with one sandbox per jj bookmark.
🤖 Written largely by AI, reviewed by a human. Use at your own risk.
- Run agents interactively or in the background with completion notifications.
- Merge or rebase tasks from separate jj workspaces with agent assistance.
- Follow each bookmark's prompts and merges in a history graph (
Lfor every run); delete and undo withdd/u. - Run shell or configured commands in the foreground (
:!make,:test), once in the repository background (:&test), or in each selected workspace (:*test); see the command comparison. Map any form to leader keys. - Let project-sandbox handle isolation, credentials and workspace teardown.
sbx-tui ~/workspace/myproject 5 bookmarks · 1 running
bookmark vs main reviewed head subject status
@ working copy ● ↑1 qzmvtlno (no description set)
▶─╮ merge/parser-tui ↑6 Δ9 0/9 wnrtlxqz Merge feature/parser, spike… merging
✓ │ feature/parser ↑3 Δ5 5/5 sutnpmvo Add streaming parser completed
│ ✗ spike/tui ↑2 ↓1 Δ4 1/4 zsuskuln Try a ranger-style layout failed (1)
│ │ ○ fix/flaky-tests ↑1 Δ2 0/2 rlvkpnrz Stabilise integration tests
○─┴─╯ main ● = kxyrwpsn Initial import
Requirements
- Linux or macOS (WSL on Windows)
- Python ≥ 3.12 and uv
- jj ≥ 0.46 on
PATH; for an existing Git repository, runjj git init --colocate - project-sandbox ≥ 0.2.2 and Apple Containers, Docker or Podman
Getting started
uv tool install project-sandbox
uv tool install project-sandbox-tui
# For latest from Github:
# uv tool install git+https://github.com/pkrusche/project-sandbox-tui
# From a checkout: uv tool install . (or uv sync && uv run sbx-tui)
cd ~/workspace/myproject
sbx-tui --init # detect the project type, write config and install a local setup skill
sbx-tui doctor # check dependencies, runtime and configuration
sbx-tui --dry-run # preview project-sandbox calls
sbx-tui # launch
Press ? for full help.
--init detects a root Dockerfile, Python/uv, Rust/Cargo or Node/npm project
(in that order). It installs a gitignored sbx-tui-config agent skill to help
tailor the configuration. Existing config and skill files are preserved; see
initialization for detection and skill paths.
Documentation
- Usage and keys
- Worked example: foreground and background commands
- Sessions, terminals and notifications
- Merging and rebasing
- Workspace cleanup
- Configuration
- Model suggestions
- Architecture
- Development
License
Metadata
Release files for project-sandbox-tui 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| project_sandbox_tui-0.1.1.tar.gz | 281.1 kB | Without provenance | Details for project_sandbox_tui-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| project_sandbox_tui-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for project_sandbox_tui-0.1.1-py3-none-any.whl |
Total release size: 432.1 kB
Release files / project_sandbox_tui-0.1.1.tar.gz
| Download URL | project_sandbox_tui-0.1.1.tar.gz |
|---|---|
| Size | 281.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
25680df053b9c7813b824090eb2931be51634a5997ce00e59cc667088e6b2ab9
|
|
BLAKE2b-256 checksum How to use checksums |
475164a7cfcb4d35ff6030d1cdf27b3df47b3fa5fde18723989ea33ea184e7f6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / project_sandbox_tui-0.1.1-py3-none-any.whl
| Download URL | project_sandbox_tui-0.1.1-py3-none-any.whl |
|---|---|
| Size | 151.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
99ae289803163856e38039de194a54bcdefa611603bb0b1a87e7fb2678bad85f
|
|
BLAKE2b-256 checksum How to use checksums |
4416a09a886b5b4b4aea7b6607b13daa98bcb783280a18554db0dfe89a706601
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for project-sandbox-tui 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.