Skip to main content

project-sandbox-tui

PyPI

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 (L for every run); delete and undo with dd / 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, run jj 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

License

MIT

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)

Source distribution for project-sandbox-tui 0.1.1
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)

Table of built distributions (wheels) for project-sandbox-tui 0.1.1
File Interpreter ABI Platform Actions
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.

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