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.2

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.2
File Size Uploaded Provenance Actions
project_sandbox_tui-0.1.2.tar.gz 288.1 kB Without provenance Details for project_sandbox_tui-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for project-sandbox-tui 0.1.2
File Interpreter ABI Platform Actions
project_sandbox_tui-0.1.2-py3-none-any.whl Python 3 none any Details for project_sandbox_tui-0.1.2-py3-none-any.whl

Total release size: 441.8 kB

Release files / project_sandbox_tui-0.1.2.tar.gz

Download URL project_sandbox_tui-0.1.2.tar.gz
Size 288.1 kB
Tags Source
SHA-256 checksum
How to use checksums
7d8ebecb06359b2e6a5be446400fd04642a6bfac882c1e433504bffab182fd4e
BLAKE2b-256 checksum
How to use checksums
b8853b935869b158b3a3ca9567bd732df44a4cb6cc4836ee7771f572e0658017
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.2-py3-none-any.whl

Download URL project_sandbox_tui-0.1.2-py3-none-any.whl
Size 153.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fe65952b553bf8f2b28e6b8bdd67cdc122bcd16b5f1e2b37084052d3c6189b2c
BLAKE2b-256 checksum
How to use checksums
17508eb1fbebefbcb0b027eb705ed52113e0ede477e285f2b109da9a4a1cc769
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.2

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