Repository navigation
Conversation
…and mount activation
Try this branchThe engine and the scripts resolve independently, so this runs the changed export COMMUNITY_SCRIPTS_URL=https://raw.githubusercontent.com/jmoredev/DevScripts/feat-gentle-shell
bash -c "$(curl -fsSL "$COMMUNITY_SCRIPTS_URL/ct/gentle-shell.sh")"Both lines are needed. Without The same command works on an Incus host: the engine detects the platform and Useful while testing
export COMMUNITY_SCRIPTS_URL=https://raw.githubusercontent.com/jmoredev/DevScripts/feat-gentle-shell
dev_mode=net,keep bash -c "$(curl -fsSL "$COMMUNITY_SCRIPTS_URL/ct/gentle-shell.sh")"Against a core branch as wellAdd |
Proxmox script test@jmoredev ✅ 2/2 passed at
ARM64 (information only, not counted): 1/1 passed. 📊 Resources
📄 ct/gentle-shell.sh (pve) — install log (1070 lines)🔄 ct/gentle-shell.sh (pve) — update log (22 lines)📄 ct/gentle-shell.sh (incus) — install log (300 lines)🔄 ct/gentle-shell.sh (incus) — update log (17 lines)📄 ct/gentle-shell.sh (arm64) — install log (300 lines)🔄 ct/gentle-shell.sh (arm64) — update log (17 lines)Full logs: workflow run (artifacts |
✍️ Description
gentle-shell is a coding-agent workspace and TUI harness built for Pi (agent orchestration, task tracking, Git diffs and persistent memory, driven from the terminal); this CT creates an LXC development server with Node 22, gentle-shell (npm
gentle-pi), git and the GitHub CLI preinstalled, meant to be driven remotely from the Gentle Shell desktop app via Herdr. The script follows the standard one-click shape: the CT script only declares defaults and the update path, all setup lives in the install script, and projects go to /root/projects (an mp0 bind mount can be added from the Proxmox UI for host directories). One deliberate deviation: access is SSH-key based (the base template clears the root password), so the install optionally installs an SSH public key fromvar_authorized_keyor an in-container prompt, with warn-and-skip on invalid input. Steps from the upstream npm package (Node 22,npm install -g gentle-pi). Tested on a real Proxmox VE 9.2.26 host: interactive and unattended install, in-container update and a full Herdr remote session with remote login.AI-assisted (GLM-5.3 via the Gentle Shell / Pi harness, high reasoning) following
AGENTS.mdand the script-creator agent guidance, then reviewed and corrected against the project conventions.🔗 Related PR / Issue
Link: Refs #2687
Rework of #2688 after maintainer feedback (setup moved into the install script, CT back to the standard minimal shape, storage-selection menus removed).
✅ Prerequisites (X in brackets)
🧩 Script
Name: gentle-shell
Tool: AI coding-agent workspace and TUI harness for Pi: parallel coding agents, task tracking, Git diffs and persistent memory in one terminal. This CT provisions a ready-to-use LXC development server for it.
🗂️ Category (X in brackets)
ct/+install/)vm/)tools/addon/tools/pve/🖥️ Platform – tested on (X in brackets)
🏗️ Architecture (X in brackets)
🛠️ Type of Change (X in brackets)
README,AppName.md,CONTRIBUTING.md, or other docs.🔍 Code & Security Review (X in brackets)
CODE-AUDIT.md&CONTRIBUTING.mdguidelinesAppName.sh,AppName-install.sh,AppName.json)fetch_and_deploy_gh_release,fetch_and_deploy_codeberg_release,fetch_and_deploy_gl_release, orfetch_and_deploy_from_urlinstead ofgit pull.📋 Additional Information (optional)
The update path refreshes
gentle-pithrough npm (npm view gentle-pi version+npm install -g gentle-pi@<version>), which is upstream's own distribution channel. Testing feedback is collected in #2687 (var_testurlpoints there).📦 Application Requirements (for new scripts)
🌐 Source
npm install -g gentle-pi) and the repo's published releases.🤖 AI Assistance (X in brackets)
AGENTS.mdand.github/agents/pve-script-creator.agent.mdas guidance, and the output has been reviewed and corrected to match those guidelines.Please describe to which degree, if any, an LLM was used in creating this pull request.
GLM-5.3 (via the Gentle Shell / Pi coding-agent harness), high reasoning, used to draft and iterate
ct/gentle-shell.sh,install/gentle-shell-install.shandjson/gentle-shell.jsonagainstAGENTS.md, then manually reviewed and tested end-to-end on a real Proxmox VE 9.2.26 host (install, unattended install, update inside the container, SSH-key flow and a full Herdr remote session).