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.
  • Save agent, model and sandbox options as named profiles, selectable in launch forms.
  • Review changes commit by commit, with shared seen marks and your place remembered during the TUI session.
  • Merge or rebase tasks from separate jj workspaces with agent assistance.
  • Follow each bookmark's prompts and merges in a history graph (O 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.

Highlight @ or a feature bookmark and press i for an interactive sandbox session or r to run or queue a background prompt (L manages the queue). Use :config-profiles to save an agent setup, then choose it in either launch form. Select custom to adjust settings for a run.

See initialization for project detection and the local sbx-tui-config setup skill. Existing config and skill files are preserved.

Documentation

License

MIT

Metadata

Release files for project-sandbox-tui 0.2.0

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.2.0
File Size Uploaded Provenance Actions
project_sandbox_tui-0.2.0.tar.gz 321.2 kB Without provenance Details for project_sandbox_tui-0.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 492.5 kB

Release files / project_sandbox_tui-0.2.0.tar.gz

Download URL project_sandbox_tui-0.2.0.tar.gz
Size 321.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f1bc10be2060bd98148a70fe8cececb725253fddaff37c74b6526f0d6f0da654
BLAKE2b-256 checksum
How to use checksums
c638781fc1416a68ac7f68b9b880d339e5726082403cfed2387f4ad9e2f5867f
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.2.0-py3-none-any.whl

Download URL project_sandbox_tui-0.2.0-py3-none-any.whl
Size 171.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e05734cf67d9fa8e34f8608fa79055fb4c3f282d965e4c199f19abf430854ed1
BLAKE2b-256 checksum
How to use checksums
2008c24d99d662a3afb632e6f2991e9aaf9f263f075005e068a5970999190c8d
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.2.0

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